Android对话框组件。包括提示性对话框、确认对话框、输入对话框、菜单型对话框、单选、多选对话框、带进度条的对话框、loading对话框、以及自定义对话框等。

Material Dialog

遵循谷歌Material Design设计风格的对话框，api与系统同步，对不同尺寸的设备以及系统版本做了兼容。

  • 简单的提示性对话框

Dialog - 图1

  1. new MaterialDialog.Builder(getContext())
  2.         .iconRes(R.drawable.icon_tip)
  3.         .title(R.string.tip_infos)
  4.         .content(R.string.content_simple_confirm_dialog)
  5.         .positiveText(R.string.lab_submit)
  6.         .show();
  8. //使用DialogLoader可自由切换dialog显示的策略
  9. DialogLoader.getInstance().showTipDialog(...);
  • 简单的确认对话框

Dialog - 图2

  1. new MaterialDialog.Builder(getContext())
  2.         .content(R.string.tip_bluetooth_permission)
  3.         .positiveText(R.string.lab_yes)
  4.         .negativeText(R.string.lab_no)
  5.         .show();
  7. //使用DialogLoader可自由切换dialog显示的策略
  8. DialogLoader.getInstance().showConfirmDialog(...);
  • 简单带输入的对话框

Dialog - 图3

  1. new MaterialDialog.Builder(getContext())
  2.         .iconRes(R.drawable.icon_warning)
  3.         .title(R.string.tip_warning)
  4.         .content(R.string.content_warning)
  5.         .inputType(
  6.                 InputType.TYPE_CLASS_TEXT
  7.                         | InputType.TYPE_TEXT_VARIATION_VISIBLE_PASSWORD
  8.                         | InputType.TYPE_TEXT_FLAG_CAP_WORDS)
  9.         .input(
  10.                 getString(R.string.hint_please_input_password),
  11.                 "",
  12.                 false,
  13.                 ((dialog, input) -> Toast(input.toString())))
  14.         .inputRange(3, 5)
  15.         .positiveText(R.string.lab_continue)
  16.         .negativeText(R.string.lab_change)
  17.         .onPositive(((dialog, which) -> Toast("你输入了:" + dialog.getInputEditText().getText().toString())))
  18.         .cancelable(false)
  19.         .show();
  21. //使用DialogLoader可自由切换dialog显示的策略
  22. DialogLoader.getInstance().showInputDialog(...);
  • 菜单型对话框

Dialog - 图4

  1. new MaterialDialog.Builder(getContext())
  2.         .title(R.string.tip_options)
  3.         .items(R.array.menu_values)
  4.         .itemsCallback((dialog, view, which, text) -> Toast(which + ": " + text))
  5.         .show();
  7. //使用DialogLoader可自由切换dialog显示的策略
  8. DialogLoader.getInstance().showContextMenuDialog(...);
  • 单选对话框

Dialog - 图5

  1. new MaterialDialog.Builder(getContext())
  2.         .title(R.string.tip_capture_setting)
  3.         .items(R.array.lead_name_choice_entry)
  4.         .itemsCallbackSingleChoice(
  5.                 0,
  6.                 (dialog, view, which, text) -> {
  7.                     Toast(which + ": " + text);
  8.                     return true; // allow selection
  9.                 })
  10.         .positiveText(R.string.lab_choice)
  11.         .negativeText(R.string.lab_cancel)
  12.         .show();
  14. //使用DialogLoader可自由切换dialog显示的策略
  15. DialogLoader.getInstance().showSingleChoiceDialog(...);
  • 多选对话框

Dialog - 图6

  1. new MaterialDialog.Builder(getContext())
  2.         .title(R.string.tip_capture_setting)
  3.         .items(R.array.lead_name_choice_entry)
  4.         .itemsCallbackMultiChoice(
  5.                new Integer[]{0, 1},
  6.                 (dialog, which, text) -> {
  7.                     StringBuilder sb = new StringBuilder("选中：\n");
  8.                     for (int i = 0; i < which.length; i ++){
  9.                         sb.append(which[i]).append(":").append(text[i]).append("\n");
  10.                     }
  11.                     Toast(sb.toString());
  12.                     return true; // allow selection
  13.                 })
  14.         .positiveText(R.string.lab_choice)
  15.         .negativeText(R.string.lab_cancel)
  16.         .show();
  • 水平有进度的进度条对话框

Dialog - 图7

  1. new MaterialDialog.Builder(getContext())
  2.         .title(R.string.tip_update)
  3.         .content(R.string.content_downloading)
  4.         .contentGravity(GravityEnum.CENTER)
  5.         .progress(false, 150, true)
  6.         .cancelListener(
  7.                 dialog -> {
  8.                     if (thread != null) {
  9.                         thread.interrupt();
  10.                     }
  11.                 })
  12.         .showListener(
  13.                 dialogInterface -> {
  14.                     updateProgress((MaterialDialog) dialogInterface);
  15.                 })
  16.         .negativeText(R.string.lab_cancel)
  17.         .show();
  • 环形无进度的进度条对话框

Dialog - 图8

  1. new MaterialDialog.Builder(getContext())
  2.         .iconRes(R.drawable.icon_sex_man)
  3.         .limitIconToDefaultSize()
  4.         .title(R.string.tip_patient_name)
  5.         .content(R.string.content_wait_for_receive_data)
  6.         .progress(true, 0)
  7.         .progressIndeterminateStyle(false)
  8.         .negativeText(R.string.lab_cancel)
  9.         .show();
  • 带图标条目的Dialog

Dialog - 图9

  1. List<MaterialSimpleListItem> list = new ArrayList<>();
  2. list.add(new MaterialSimpleListItem.Builder(getContext())
  3.         .content(R.string.lab_edit)
  4.         .icon(R.drawable.icon_edit)
  5.         .iconPaddingDp(8)
  6.         .build());
  7. list.add(new MaterialSimpleListItem.Builder(getContext())
  8.         .content(R.string.lab_add)
  9.         .icon(R.drawable.icon_add)
  10.         .build());
  11. list.add(new MaterialSimpleListItem.Builder(getContext())
  12.         .content(R.string.lab_delete)
  13.         .icon(R.drawable.icon_delete)
  14.         .build());
  15. list.add(new MaterialSimpleListItem.Builder(getContext())
  16.         .content(R.string.lab_update)
  17.         .icon(R.drawable.icon_update)
  18.         .iconPaddingDp(8)
  19.         .build());
  20. final MaterialSimpleListAdapter adapter = new MaterialSimpleListAdapter(list)
  21.         .setOnItemClickListener(new MaterialSimpleListAdapter.OnItemClickListener() {
  22.             @Override
  23.             public void onMaterialListItemSelected(MaterialDialog dialog, int index, MaterialSimpleListItem item) {
  24.                 ToastUtils.toast(item.getContent().toString());
  25.             }
  26.         });
  27. new MaterialDialog.Builder(getContext()).adapter(adapter, null).show();
  • 自定义对话框

Dialog - 图10

  1. new MaterialDialog.Builder(getContext())
  2.         .customView(R.layout.dialog_custom, true)
  3.         .title("自定义对话框")
  4.         .positiveText(R.string.lab_submit)
  5.         .negativeText(R.string.lab_cancel)
  6.         .show();
  8. //或者继承CustomMaterialDialog实现

常用方法

  • 设置标题：title(CharSequence title)
  • 设置标题的对齐方式： titleGravity(GravityEnum gravity)
  • 设置标题字体的颜色：titleColor(int color)
  • 设置对话框的图标：icon(Drawable icon)
  • 设置对话框的内容：content(CharSequence content)
  • 设置对话框内容的文字颜色：contentColor(int color)
  • 设置对话框内容的对齐方式：contentGravity(GravityEnum gravity)
  • 设置对话框列表内容的集合：items(Collection collection)
  • 设置对话框列表的点击回调：itemsCallback(ListCallback callback)
  • 设置对话框列表的长按点击回调：itemsLongCallback( ListLongCallback callback)
  • 设置对话框列表字体的颜色：itemsColor(int color)
  • 设置对话框列表单选监听：itemsCallbackSingleChoice(int selectedIndex, ListCallbackSingleChoice callback)
  • 设置对话框列表多选监听：itemsCallbackMultiChoice(Integer[] selectedIndices, ListCallbackMultiChoice callback)
  • 设置确定按钮的文字：positiveText(CharSequence message)
  • 设置确定按钮的点击回调：onPositive(SingleButtonCallback callback)
  • 设置确定按钮文字的颜色：positiveColor(int color)
  • 设置中性按钮的文字：neutralText(CharSequence message)
  • 设置中性按钮的点击回调：onNeutral(SingleButtonCallback callback)
  • 设置否定按钮的文字：negativeText(CharSequence message)
  • 设置否定按钮的点击回调：onNegative(SingleButtonCallback callback)
  • 设置对话框列表的点击效果
    ：listSelector(int selectorRes)
  • 设置按钮的点击效果
    ：btnSelector(int selectorRes)
  • 设置对话框自定义布局：customView(int layoutRes, boolean wrapInScrollView)
  • 设置对话框进度条：progress(boolean indeterminate, int max)
  • 设置对话框点击外部是否可消失：cancelable(boolean cancelable)
  • 设置对话框的显示监听：showListener(OnShowListener listener)
  • 设置对话框的消失监听：dismissListener(OnDismissListener listener)
  • 设置对话框的取消监听：cancelListener(OnCancelListener listener)
  • 设置对话框输入框的样式：input(
CharSequence hint,
 CharSequence prefill,
 boolean allowEmptyInput,
 InputCallback callback)

DialogLoader

对话框加载者，可自定义对话框的加载策略。框架默认提供了两套加载策略：AlertDialogStrategy 和 MaterialDialogStrategy。 默认使用的是MaterialDialogStrategy。

设置加载的策略

  1. DialogLoader.getInstance().setIDialogStrategy(...);

策略方法

  • 显示简要的提示对话框：showTipDialog
  • 显示简要的确认对话框：showConfirmDialog
  • 显示带输入框的对话框：showInputDialog
  • 显示类似上下文菜单的对话框：showContextMenuDialog
  • 显示带单选项的对话框：showSingleChoiceDialog

BottomSheet

底部弹出对话框，支持List和Grid两种形式。

List形式

Dialog - 图11

  1. new BottomSheet.BottomListSheetBuilder(getActivity())
  2.         .addItem("Item 1")
  3.         .addItem("Item 2")
  4.         .addItem("Item 3")
  5.         .setOnSheetItemClickListener(new BottomSheet.BottomListSheetBuilder.OnSheetItemClickListener() {
  6.             @Override
  7.             public void onClick(BottomSheet dialog, View itemView, int position, String tag) {
  8.                 dialog.dismiss();
  9.                 ToastUtils.toast("Item " + (position + 1));
  10.             }
  11.         })
  12.         .build()
  13.         .show();

Grid形式

Dialog - 图12

  1. BottomSheet.BottomGridSheetBuilder builder = new BottomSheet.BottomGridSheetBuilder(getActivity());
  2.     builder
  3.         .addItem(R.drawable.icon_more_operation_share_friend, "分享到微信", TAG_SHARE_WECHAT_FRIEND, BottomSheet.BottomGridSheetBuilder.FIRST_LINE)
  4.         .addItem(R.drawable.icon_more_operation_share_moment, "分享到朋友圈", TAG_SHARE_WECHAT_MOMENT, BottomSheet.BottomGridSheetBuilder.FIRST_LINE)
  5.         .addItem(R.drawable.icon_more_operation_share_weibo, "分享到微博", TAG_SHARE_WEIBO, BottomSheet.BottomGridSheetBuilder.FIRST_LINE)
  6.         .addItem(R.drawable.icon_more_operation_share_chat, "分享到私信", TAG_SHARE_CHAT, BottomSheet.BottomGridSheetBuilder.FIRST_LINE)
  7.         .addItem(R.drawable.icon_more_operation_save, "保存到本地", TAG_SHARE_LOCAL, BottomSheet.BottomGridSheetBuilder.SECOND_LINE)
  8.         .setOnSheetItemClickListener(new BottomSheet.BottomGridSheetBuilder.OnSheetItemClickListener() {
  9.             @Override
  10.             public void onClick(BottomSheet dialog, BottomSheetItemView itemView) {
  11.                 dialog.dismiss();
  12.                 int tag = (int) itemView.getTag();
  13.                 ToastUtils.toast("tag:" + tag + ", content:" + itemView.toString());
  14.             }
  15.         }).build().show();

LoadingDialog

自定义的loading对话框，支持更新提示信息，修改图标配置，旋转速度等。

  • 演示效果

Dialog - 图13

  • 使用案例
  1. mLoadingDialog = WidgetUtils.getLoadingDialog(getContext())
  2.             .setIconScale(0.4F)
  3.             .setLoadingSpeed(8);

常用方法

  • 更新提示信息：updateMessage(String tipMessage)
  • 修改图标配置：setLoadingIcon(Drawable icon)
  • 资源回收：Recycle()
  • 设置loading旋转的速度：setLoadingSpeed(int speed)

MiniLoadingDialog

自定义的loading对话框，类似IOS的loading加载框，支持更新提示信息。

  • 演示效果

Dialog - 图14

  • 使用案例
  1. mMiniLoadingDialog =  WidgetUtils.getMiniLoadingDialog(getContext());