Android AlertDialog筆記

安卓開發 · 發表 2019-01-27 22:23:25

摘要：官方文件彈出框，用於提示使用者和進行簡單互動，可以提供最多三個按鈕，標題（ title ）和提示資訊（ message ）可以通過方法直接設定，如果需要呈現複雜佈局，也可以自定義佈局並設定。雖然現在有幾個人用的app都會自定義這種彈出提示的UI，一般不會用android原生...

官方文件

彈出框，用於提示使用者和進行簡單互動，可以提供最多三個按鈕，標題（ 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()
複製程式碼

和一般按鈕一樣，這些選項也是點選之後會自動呼叫 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)
複製程式碼

單選項的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() ，也就不會自動消失了。