Android AlertDialog笔记

官方文档

弹出框，用于提示用户和进行简单交互，可以提供最多三个按钮，标题（ title ）和提示信息（ message ）可以通过方法直接设置，如果需要呈现复杂布局，也可以自定义布局并设置。

虽然现在有几个人用的app都会自定义这种弹出提示的UI，一般不会用android原生的控件，但我还是用的很多的（UI？不存在的，只能用MD凑合凑合这样子）。

这篇笔记主要集中在一般用法和可能会踩到的坑的解决办法，不会讨论代码原理啥的。

基本使用

通常使用builder来构建一个AlertDialog：

AlertDialog.Builder(this)
	.setTitle("Notice")
	.setMessage("Some Message")
	.setPositiveButton("OK") { _, _ -> // do sth }
	.create().show()
复制代码

最简单的dialog，显示一些信息，点击ok隐藏。

注意，在 .setPositiveButton("OK") { _, _ -> // do sth } 监听方法中， dialog.dismiss() 是自动调用的，所以不用写， NegativeButton 和 NeutralButton 也一样。

自定义View

有时需要在dialog中显示输入框，提示让用户输入一些信息，在点击ok时处理输入信息。 先自定义一个布局 layout_dialog_report.xml ：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="match_parent"
    android:layout_height="match_parent">

    <EditText
        android:id="@+id/et_input"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_margin="16dp"
        android:inputType="text"/>
</LinearLayout>
复制代码

在dialog中使用：

// 获取view
val inputView = LayoutInflater.from(this).inflate(R.layout.layout_dialog_report, null)
val nameInputDialog = AlertDialog.Builder(this)
        .setTitle("请输入")
        .setView(inputView) // 设置显示的view
        .setPositiveButton("OK") { _, _ -> }
        .setNegativeButton("Cancel") { _, _ ->  }
        .create()
// 因为后面要通过dialog获取button，此时要单独获取dialog对象，然后手动show()
nameInputDialog.show()
// 获取button并设置点击事件
nameInputDialog.getButton(DialogInterface.BUTTON_POSITIVE).setOnClickListener {
    PreferenceUtil.saveNickname(inputView.et_report.text.toString())
    nameInputDialog.dismiss()
    checkJob()
}
复制代码

注意：这里的坑就是必须使用 nameInputDialog.getButton() 方法获取到button之后单独设置点击事件，使用 .setPositiveButton("OK") { _, _ -> } 方法不起作用。

除了用 setTitle() 和 setIcon() 设置标题和icon之外，还可以用 setCustomTitle (View customTitleView) 方法自定义标题样式。

选择一项的dialog

列出一组可供选择的选项，主要使用 setItems() 方法，该方法可以接受资源文件中的一组 array ，或一个 CharSequence 数组。

val jobList = arrayOf("Python", "Java", "JavaScript", "Kotlin", "C++")
AlertDialog.Builder(this)
	.setTitle("Notice")
	.setItems(jobList){ dialog, which ->
	    val selesctItem = jobList[which]
	    // do sth
	}
	.create().show()
复制代码

方法隐藏。

多选项的dialog

可供多选的列表，需要提供一组数据，同时提供一个boolean值数组，设置的监听器将监听到多选的操作变化，手动将多选的结果将保存在这个数组中。

// 可供选择的list，或一组array资源
val dbList = arrayOf("Python", "Java", "JavaScript", "Kotlin", "C++")
// 保存选择结果的list，一般在传入时
val chooseList =  arrayOf(false,false,false,false).toBooleanArray()
AlertDialog.Builder(activity)
        .setTitle("Notice")
        .setMultiChoiceItems(dbList, chooseList){ _, which, isChecked ->
            chooseList[which] = isChecked
        }
        .setPositiveButton("OK") { _, _ ->
            for (i in chooseList.indices) {
                if (chooseList[i]) {
                    // do sth
                }
            }
        }
        .create().show()
复制代码

文档中还提供了以cursor为参数的设置方法：

public AlertDialog.Builder setMultiChoiceItems (Cursor cursor, 
                String isCheckedColumn, 
                String labelColumn, 
                DialogInterface.OnMultiChoiceClickListener listener)
复制代码

单选项的dialog

这个单选与上面的单选区别在于上面那个是点击之后即时反应的，而这一种是类似多选项，选中之后还可以更改，点击按钮确定之后才会处理。具体可以看效果图。 类似于多选项的设置方式，提供array资源或者一组字符串，也可以使用cursor，并且多了一个使用 ListAdapter 的方法，第二个参数是默认选中的item index，设置为-1则表示没有默认选中的。

val items = arrayOf("同时转发到QQ","同时转发到微信","同时转发到微博");
AlertDialog.Builder(this)
    .setSingleChoiceItems(items, 1) { _, which ->
         val item = items[which]
         // do sth
     }
     .setPositiveButton("OK") { _, _ ->
	     // do sth
     }
    .create().show()
复制代码

在dialog上显示dialog

有时点击确定之后，需要在这一层上再弹出一层dialog作为二次提示或者警告，但一般确认按钮都会自动调用 dismiss() 使dialog消失。这里有两个解决办法，一是通过反射把底层dialog的状态设置为不显示，这样 dismiss() 方法就不起作用，在上层选择完之后，再手动选择是否隐藏底层dialog。原理是 dismiss() 方法会先判断 "mShowing" 这个属性然后再隐藏dialog。 一个两层dialog的例子：

AlertDialog.Builder(this)
	.setTitle("Notice")
	.setItems(jobList){ out, which ->
	     val field = out?.javaClass?.superclass?.getDeclaredField(
	                     "mShowing")
	     field?.isAccessible = true
	     //   将mShowing变量设为false，表示对话框已关闭
	     field?.set(out, false)
	     AlertDialog.Builder(this)
	             .setTitle(jobList[which])
	             .setMessage(PreferenceUtil.getDescForJob(jobList[which]))
	             .setPositiveButton("OK") { inner, _ ->
	                 PreferenceUtil.setJob(jobList[which])
	                 EventUtil.onEvent(this, chooseJob, jobList[which])
	                 inner.dismiss()
	                 field?.set(out, true)
	                 out.dismiss()
	             }
	             .setNegativeButton("Cancel") { dialog, _ -> dialog.dismiss() }
	             .create().show()
	 }
	 .create().show()
复制代码

第二种方法就是前面说的自定义View作为dialog的内容，则点击按钮不会自动调用 dismiss() ，也就不会自动消失了。