官方文档

弹出框,用于提示用户和进行简单交互,可以提供最多三个按钮,标题(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 隐藏。

Alt text

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

自定义 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">
<span class="hljs-tag">&lt;<span class="hljs-name">EditText</span>
    <span class="hljs-attr">android:id</span>=<span class="hljs-string">"@+id/et_input"</span>
    <span class="hljs-attr">android:layout_width</span>=<span class="hljs-string">"match_parent"</span>
    <span class="hljs-attr">android:layout_height</span>=<span class="hljs-string">"wrap_content"</span>
    <span class="hljs-attr">android:layout_margin</span>=<span class="hljs-string">"16dp"</span>
    <span class="hljs-attr">android:inputType</span>=<span class="hljs-string">"text"</span>/&gt;</span>

</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()
}
复制代码

Alt text

注意:这里的坑就是必须使用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()
复制代码

Alt text 和一般按钮一样,这些选项也是点击之后会自动调用 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)
复制代码

Alt text

单选项的 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()
复制代码

Alt text

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

Alt text

  • Android

    开放手机联盟(一个由 30 多家科技公司和手机公司组成的团体)已开发出 Android,Android 是第一个完整、开放、免费的手机平台。

    293 引用
感谢    赞同    分享    收藏    关注    反对    举报    ...