自定义AlertDialog最佳实践
AlertDialog是每一个App所必须的控件,在Android4.0之前不可否认官方正版的Dialog很不美观,但是Android4.0之后的holo风格的Dialog已经可以上的了厅堂了,再后来的Material Design设计风格的拟物扁平化Dialog已经是给人耳目一新的感觉。虽然官方UI标准愈加完善,可是部分UI设计师依然是按照苹果iOS的规范设计App的UI,完全忽略不同平台UI包括交互上的差异性,作为开发者也只好苦逼的遵循UI设计的规范,结果就是Android版本的Dialog多数情况下是以自定义UI风格的方式呈现。系统官方的AlertDialog使用了建造者模式,并且可以链式调用相当方便,所以这次从系统中剥离了AlertDialog源码并进行部分改动以便适用于不同风格。
自定义AlertDialog支持如下方式:
- 系统AlertDialog怎么使用该AlertDialog就怎么使用;
- 支持自定义样式和主题;
- 支持自定义AlertDialog布局文件;
- 支持自定义单选复选列表弹框;
- 支持功能扩展。
AlertDialog简介
一个标准AlertDialog分为三个区域:标题区、内容区和按钮区,并且每一个区域都是可选部分。构建一个AlertDialog是使用的静态内部类Builder,三个区域需要什么就build什么,这就是建造者模式的好处。
一些常用的方法如下:
- Builder ()构造方法,默认一个参数的是Theme.Holo.Light主题,可以说设置两个参数,第二个参数可以传入主题
- setTitle ()设置标题栏文本;
- setIcon ()设置标题栏icon;
- setIconAttribute ()设置特定主题下的icon;
- setCustomTitle ()设置自定义标题栏;
- setMessage () 设置弹框内容区域文本;
- setItems () 设置弹框列表;
- setSingleChoiceItems ()设置单选模式列表;
- setMultiChoiceItems ()设置复选模式列表;
- setNegativeButton()设置左侧按钮;
- setNeutralButton ()设置中间按钮;
- setPositiveButton ()设置右侧按钮;
- setView ()设置自定义内容区域View;
- create()创建一个AlertDialog;
- show ()创建并显示一个AlertDialog。
AlertDialog的基本使用
创建一个标准AlertDialog
new Builder(this) .setTitle("title") .setMessage("hello world") .setPositiveButton("确定", new OnClickListener() { @Override public void onClick(DialogInterface dialog, int which) { dialog.dismiss(); } }).setNeutralButton("中间", new OnClickListener() { @Override public void onClick(DialogInterface dialog, int which) { dialog.dismiss(); } }).setNegativeButton("取消", new OnClickListener() { @Override public void onClick(DialogInterface dialog, int which) { dialog.dismiss(); } }).show();
创建一个无标题栏AlertDialog
只需要将上述标准Dialog中setTitle方法剔除就可以了。
创建一个深色主题AlertDialog
AlertDialog在创建的时候默认是一个浅色Theme.Holo.Light主题,在构造方法中就已经设置了,如果想要设置深色主题,可以使用两个参数的构造方法。
protected AlertDialog(Context context) { this(context, 0); } protected AlertDialog(Context context, int theme) { super(context, resolveDialogTheme(context, theme)); mAlert = new AlertController(context, this, getWindow()); } static int resolveDialogTheme(Context context, int resId) { if (resId == 0) { return R.style.DialogHoloLight; } else { return resId; } }
首先创建一个深色主题继承一个默认系统已有的深色Dialog主题。
<style name="DialogDark" parent="@android:style/Theme.DeviceDefault.Dialog"> <item name="android:alertDialogIcon">@drawable/ic_view_headline_white_24dp</item> <item name="layout">@layout/alert_dialog_dark</item>
这里我们将dialog的布局文件也重新设置了一个,并且设置了该主题下标题栏icon,代码如下:
new Builder(this,R.style.DialogDark) .setTitle("title") .setIconAttribute(android.R.attr.alertDialogIcon) .setMessage("hello world") .setPositiveButton("确定", new OnClickListener() { @Override public void onClick(DialogInterface dialog, int which) { dialog.dismiss(); } }).setNeutralButton("中间", new OnClickListener() { @Override public void onClick(DialogInterface dialog, int which) { dialog.dismiss(); } }).setNegativeButton("取消", new OnClickListener() { @Override public void onClick(DialogInterface dialog, int which) { dialog.dismiss(); } }).show();
创建一个类似iOS风格的AlertDialog
想要创建iOS风格的Dialog主要是布局文件的排版,圆角布局或者从底部滑入动画,该demo并没有加入动画。先创建一个iOS主题:
<style name="DialogIOS" parent="@android:style/Theme.Holo.Light.Dialog"> <item name="android:alertDialogIcon">@drawable/ic_view_headline_black_24dp</item> <item name="layout">@layout/alert_ios</item> <item name="android:windowBackground">@drawable/bg_dialog</item>
AlertDialog的创建方式跟上面深色主题类似,只需要在构造方法传入主题即可:
new Builder(this,R.style.DialogIOS) ...
如果创建类似QQ从底部滑入动画,只需要在主题中设置一个转场动画:
<style name="DialogIOS" parent="@android:style/Theme.Holo.Light.Dialog"> <item name="android:alertDialogIcon">@drawable/ic_view_headline_black_24dp</item> <item name="layout">@layout/alert_ios</item> <item name="android:windowBackground">@drawable/bg_dialog</item> <item name="android:windowAnimationStyle">@style/DrawerAnim</item>
创建一个列表AlertDialog
创建列表对话框,包括单复选模式实际上都是单行文本模式列表,如果想要支持更复杂列表,可以更改源码或者传入一个自定义View。
new Builder(this) .setTitle("title") .setIconAttribute(android.R.attr.alertDialogIcon) .setItems(getData(), new OnClickListener() { @Override public void onClick(DialogInterface dialog, int position) { dialog.dismiss(); } }).show();
创建单复选列表AlertDialog
不可否认系统级别的单复选icon很不好看,所以这里使用了自定义布局方式来更改系统内置默认的布局,内部文本列表使用的是CheckedTextView,这个控件一般很少用到,而这里需要更改icon就是需要该控件的checkMark属性。为checkMark属性设置一个选择器,btn_radio_right选择器如下:
<selector xmlns:android="http://schemas.android.com/apk/res/android"> <item android:state_checked="false" android:drawable="@color/transparent" /> <item android:state_checked="true" android:drawable="@drawable/ic_checked" /> </selector>
单选模式的布局文件custom_dialog_singlechoice.xml如下:
<CheckedTextView xmlns:android="http://schemas.android.com/apk/res/android" android:id="@android:id/text1" android:layout_width="match_parent" android:layout_height="wrap_content" android:minHeight="?android:attr/listPreferredItemHeightSmall" android:textAppearance="?android:attr/textAppearanceMedium" android:textColor="?android:attr/textColorAlertDialogListItem" android:gravity="center_vertical" android:paddingStart="16dip" android:paddingEnd="16dip" android:checkMark="@drawable/btn_radio_light" android:ellipsize="marquee" />
复选模式布局实现方式跟单选模式类似,这里就不贴出来了。
//单选模式 new Builder(this) .setTitle("title") .setIconAttribute(android.R.attr.alertDialogIcon) .setSingleChoiceItems(getData(), 0, new OnClickListener() { @Override public void onClick(DialogInterface dialog, int position) { dialog.dismiss(); } }).show(); //复选模式 new Builder(this) .setTitle("title") .setIconAttribute(android.R.attr.alertDialogIcon) .setMultiChoiceItems(getData(), null, new OnMultiChoiceClickListener() { @Override public void onClick(DialogInterface dialog, int position, boolean isCheked) { } }).show();
设置自定义View的AlertDialog
自定义View很简单就是使用setView方法,传入一个自定义的View,在开发中自定义View使用频率还是很高的。
new Builder(this) .setTitle("title") .setIconAttribute(android.R.attr.alertDialogIcon) .setView(View.inflate(this, R.layout.custom_layout, null)).show();
AlertDialog的销毁以及事件的监听
setCancelable(boolean cancelable)中cancelable默认值是true,这时候点击弹框外部区域或者手机返回键Dialog默认会销毁,反之,点击后Dialog不会销毁。
如果在Dialog销毁时还想处理一些逻辑,就需要借助DialogInterface中如下两个监听器:
interface OnCancelListener { public void onCancel(DialogInterface dialog); } interface OnDismissListener { public void onDismiss(DialogInterface dialog); }
Dialog销毁可以调用两个事件,分别对应这两个方法cancel和dismiss,一般情况下开发者不必在乎它们俩的差异性,当想销毁Dialog的时候,直接调用dismiss或者cancel方法,在cancel方法中实际上也调用了dismiss方法。
public void cancel() { if (!mCanceled && mCancelMessage != null) { mCanceled = true; // Obtain a new message so this dialog can be re-used Message.obtain(mCancelMessage).sendToTarget(); } dismiss(); }
从这里可以看出如果我们设置了setOnDismissListener,调用cancel和dismiss方法都会出发该监听器,但是如果设置setOnCancelListener则只会在使用cancel方法的时候出发,差别就在这里。如果Dialog被用户显式的销毁掉,这将在用户按下"back"键时,或者Dialog显式的调用cancel()(按下Dialog的cancel按钮)时发生,当一个Dialog被销毁时, OnDismissListener将仍然被通知, 但如果你希望在对话框被显示销毁(而不是正常解除)时被通知,则你应该使用setOnCancelListener()注册一个DialogInterface.OnCancelListener。
AlertDialog全屏
AlertDialog默认是不全屏的,如果想设置全屏可以使用如下方式:
View view=View.inflate(this, R.layout.layout_custom01, null); //必须设置该属性 view.setMinimumWidth(screenWidth); AlertDialog.Builder builder = new Builder(this) .setTitle("title").setView(view); AlertDialog dialog=builder.create(); Window dialogWindow = dialog.getWindow(); //设置屏幕底部居左对齐 dialogWindow.setGravity(Gravity.LEFT | Gravity.BOTTOM); WindowManager.LayoutParams lp = dialogWindow.getAttributes(); lp.x = 0; lp.y = 0; dialogWindow.setAttributes(lp); dialog.show();
小结
AlertDialog简单使用基本先到这里,有关AlertDialog代码实现机制在以后的文章中再做解析。官方不建议开发者直接使用Dialog来创建弹出框,所以提供了AlertDialog,但是Android3.0以后官方又提供了一个新的类DialogFragment,说DialogFragment拥有比AlertDialog更优的用户体验,因为它可以跟Fragment生命周期绑定,有关DialogFragment使用后续文章也会简单介绍一下,个人认为以简单实用为上,既然AlertDialog可以满足平常开发需要,非特殊需求我还是选择AlertDialog。开发中有时候会遇到一些从底部上滑进入的弹框,如购物车或者支付宝支付信息界面,这种情况下可以在AlertDialog使用自定义动画满足需求,但是由于这种交互非常常见,所以Google官方又提供了一个吊炸天的控件BottomSheetDialog,最先引入大概是在support v23.2支持包中,也同样有跟Fragment绑定的工具是BottomSheetDialogFragment,该控件算是弥补了SlidingDrawer、DrawerLayout、PopupWindow以及AlertDialog的在底部弹框交互上的不足,走到这里我只想说一个词:"shit",为什么这些控件不早一天出现。