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隐藏。

image.png

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

自定义View

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

在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()
}

image.png

注意：这里的坑就是必须使用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()

image.png

和一般按钮一样，这些选项也是点击之后会自动调用dismiss()方法隐藏。

多选项的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)

image.png

单选项的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()

image.png

在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()，也就不会自动消失了。

image.png