The text is updated when the Dialog launches and on user clicks.
*
* @param selection The current user selection
*/
protected abstract String getHeaderText(@Nullable S selection);
/** Returns an {@link @AttrRes} to apply as a theme overlay to the DialogFragment */
protected abstract int getDefaultThemeAttr();
/**
* Creates the {@link GridSelector} used for the {@link MaterialCalendar} in this {@link
* DialogFragment}.
*/
protected abstract GridSelector createGridSelector();
private SimpleDateFormat simpleDateFormat;
@AttrRes private int themeResId;
private GridSelector gridSelector;
private CalendarBounds calendarBounds;
@StringRes private int titleTextResId;
private MaterialCalendar materialCalendar;
private TextView header;
private S selection;
/**
* Adds the super class required arguments to the Bundle.
*
*
Call this method in subclasses before the initial call to {@link
* DialogFragment#setArguments(Bundle)}
*
* @param args The Bundle from the subclassing DialogFragment
* @param themeResId 0 or a {@link StyleRes} representing a ThemeOverlay
*/
protected static void addArgsToBundle(
Bundle args,
int themeResId,
CalendarBounds calendarBounds,
@StringRes int overlineTextResId) {
args.putInt(THEME_RES_ID_KEY, themeResId);
args.putParcelable(CALENDAR_BOUNDS_KEY, calendarBounds);
args.putInt(TITLE_TEXT_RES_ID_KEY, overlineTextResId);
}
@StyleRes
private static int getThemeResource(Context context, int defaultThemeAttr, int themeResId) {
if (themeResId != 0) {
return themeResId;
}
return MaterialAttributes.resolveOrThrow(
context, defaultThemeAttr, MaterialPickerDialogFragment.class.getCanonicalName());
}
@Override
public final void onSaveInstanceState(Bundle bundle) {
super.onSaveInstanceState(bundle);
bundle.putInt(THEME_RES_ID_KEY, themeResId);
bundle.putParcelable(GRID_SELECTOR_KEY, gridSelector);
bundle.putParcelable(CALENDAR_BOUNDS_KEY, calendarBounds);
bundle.putInt(TITLE_TEXT_RES_ID_KEY, titleTextResId);
}
@Override
public final void onCreate(@Nullable Bundle bundle) {
super.onCreate(bundle);
simpleDateFormat =
new SimpleDateFormat(
getResources().getString(R.string.mtrl_picker_date_format), Locale.getDefault());
Bundle activeBundle = bundle == null ? getArguments() : bundle;
themeResId =
getThemeResource(
getContext(), getDefaultThemeAttr(), activeBundle.getInt(THEME_RES_ID_KEY));
gridSelector = activeBundle.getParcelable(GRID_SELECTOR_KEY);
calendarBounds = activeBundle.getParcelable(CALENDAR_BOUNDS_KEY);
titleTextResId = activeBundle.getInt(TITLE_TEXT_RES_ID_KEY);
if (gridSelector == null) {
gridSelector = createGridSelector();
}
materialCalendar = MaterialCalendar.newInstance(gridSelector, themeResId, calendarBounds);
}
@Override
public final Dialog onCreateDialog(@Nullable Bundle bundle) {
return new Dialog(requireContext(), themeResId);
}
@NonNull
@Override
public final View onCreateView(
@NonNull LayoutInflater layoutInflater,
@Nullable ViewGroup viewGroup,
@Nullable Bundle bundle) {
View root = layoutInflater.inflate(R.layout.mtrl_picker_dialog, viewGroup);
header = root.findViewById(R.id.mtrl_picker_header_text);
((TextView) root.findViewById(R.id.mtrl_picker_title_text)).setText(titleTextResId);
MaterialButton confirmButton = root.findViewById(R.id.confirm_button);
confirmButton.setTag(CONFIRM_BUTTON_TAG);
confirmButton.setOnClickListener(
new View.OnClickListener() {
@Override
public void onClick(View v) {
selection = materialCalendar.getSelection();
dismiss();
}
});
MaterialButton cancelButton = root.findViewById(R.id.cancel_button);
cancelButton.setTag(CANCEL_BUTTON_TAG);
cancelButton.setOnClickListener(
new View.OnClickListener() {
@Override
public void onClick(View v) {
selection = null;
dismiss();
}
});
return root;
}
@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle bundle) {
super.onViewCreated(view, bundle);
FragmentTransaction fragmentTransaction = getChildFragmentManager().beginTransaction();
fragmentTransaction.replace(R.id.mtrl_calendar_frame, materialCalendar);
fragmentTransaction.commit();
}
@Override
public void onStart() {
super.onStart();
updateHeader(materialCalendar.getSelection());
materialCalendar.addOnSelectionChangedListener(
new OnSelectionChangedListener() {
@Override
public void onSelectionChanged(S selection) {
updateHeader(selection);
}
});
}
@Override
public void onStop() {
materialCalendar.clearOnSelectionChangedListeners();
super.onStop();
}
@Override
public final void onDismiss(@NonNull DialogInterface dialogInterface) {
ViewGroup viewGroup = ((ViewGroup) getView());
if (viewGroup != null) {
viewGroup.removeAllViews();
}
super.onDismiss(dialogInterface);
}
/**
* Returns a {@link S} instance representing the selection or null if the user has not confirmed a
* selection.
*/
@Nullable
public final S getSelection() {
return selection;
}
/**
* Sets a date formatter.
*
*
Useful when the default localized date format is inadequate */ public final void setSimpleDateFormat(SimpleDateFormat simpleDateFormat) { this.simpleDateFormat = simpleDateFormat; } /** Returns a localized date formatter */ public final SimpleDateFormat getSimpleDateFormat() { return simpleDateFormat; } /** * Returns the {@link MaterialCalendar} based on a previous call to {@link * MaterialPickerDialogFragment#createGridSelector()} * *
Returns null until after {@link DialogFragment#onCreate} */ @Nullable public final MaterialCalendar getMaterialCalendar() { return materialCalendar; } private void updateHeader(S selection) { header.setText(getHeaderText(selection)); } }