Android AlertDialog筆記

朱子宥發表於2019-01-27
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隱藏。

Alt text

注意，在.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()
}
複製程式碼

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

相關文章