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

和一般按鈕一樣，這些選項也是點擊之後會自動調用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()，也就不會自動消失了。