AlertDialog詳解指南

一、AlertDialog的概念與基礎用法

AlertDialog是一款常用於展示一些重要提示信息的彈窗控件，它可以幫助我們在當前界面之上快速彈出一個窗口，對用戶進行信息提示、數據操作等。在Android中，AlertDialog可以通過AlertDialog.Builder類來構建並進行各種設置。

基礎的AlertDialog使用代碼示例：

AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setTitle("標題")
        .setMessage("提示信息")
        .setPositiveButton("確定", new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {
                //確定按鈕點擊事件
            }
        })
        .setNegativeButton("取消", new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {
                //取消按鈕點擊事件
            }
        })
        .show();

通過上面的代碼，我們可以快速構建一個簡單的AlertDialog彈窗，在彈窗內展示一段提示信息，並提供“確定”和“取消”按鈕，來實現基本的交互功能。

二、AlertDialog的各項屬性設置

除了基本的標題、內容、按鈕等設置之外，AlertDialog還提供了豐富的屬性、樣式、自定義布局等設置，下面我們將逐一介紹。

1. 標題和內容設置

AlertDialog.Builder提供了setTitle()、setMessage()方法用於設置標題和內容，代碼示例如下：

builder.setTitle("標題")
        .setMessage("提示信息")

此外，還可以通過setIcon()方法來設置彈窗的圖標：

builder.setIcon(R.drawable.ic_info)

2. 按鈕設置

默認情況下，AlertDialog會提供“確定”和“取消”按鈕，我們可以通過setPositiveButton()和setNegativeButton()方法來設置這兩個按鈕的文本和點擊事件，代碼示例如下：

builder.setPositiveButton("確定", new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {
                //確定按鈕點擊事件
            }
        })
        .setNegativeButton("取消", new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {
                //取消按鈕點擊事件
            }
        })

另外，還可以使用setNeutralButton()方法來設置中間的按鈕。

3. 設置取消不可用

我們可以通過setCancelable()方法來控制用戶是否可以通過點擊彈窗之外的區域來取消彈窗。默認情況下，該方法的參數為true，即可以通過點擊之外的區域來取消彈窗。如果我們不希望用戶取消彈窗，可以將其設置為false，代碼示例如下：

builder.setCancelable(false)

4. 設置列表

有時候，我們需要向用戶展示一個列表，在AlertDialog中，我們可以使用setItems()方法來實現。setItems()方法有兩個參數，第一個參數為一個CharSequence數組，代表列表顯示的項，第二個參數為點擊事件的回調函數。

final String[] items = {"選項1", "選項2", "選項3"};
builder.setItems(items, new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {
                //列表項點擊事件
                Toast.makeText(getApplicationContext(), items[which], Toast.LENGTH_SHORT).show();
            }
        })

5. 設置單選列表

與setItems()類似，但是單選列表只允許用戶選擇一項，可以使用setSingleChoiceItems()方法來實現。setSingleChoiceItems()方法有四個參數，前三個與setItems()方法相同，第四個參數指定默認選中項的位置。

final String[] items = {"單選1", "單選2", "單選3"};
builder.setSingleChoiceItems(items, 0, new DialogInterface.OnClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which) {
                //單選列表項點擊事件
                Toast.makeText(getApplicationContext(), items[which], Toast.LENGTH_SHORT).show();
            }
        })

6. 設置多選列表

與setItems()類似，但是多選列表允許用戶同時選擇多個選項，可以使用setMultiChoiceItems()方法來實現。setMultiChoiceItems()方法有四個參數，前三個與setItems()方法相同，第四個參數指定默認選中項的布爾數組。

final String[] items = {"多選1", "多選2", "多選3"};
final boolean[] checkedItems = {false, true, false};
builder.setMultiChoiceItems(items, checkedItems, new DialogInterface.OnMultiChoiceClickListener() {
            @Override
            public void onClick(DialogInterface dialog, int which, boolean isChecked) {
                //多選列表項點擊事件
                checkedItems[which] = isChecked;
            }
        })

7. 自定義布局

除了上述幾種設置外，我們還可以通過setView()方法來加載自定義布局。該方法的參數可以是一個View，也可以是一個布局文件的資源ID。

View view = LayoutInflater.from(this).inflate(R.layout.custom_layout, null);
builder.setView(view);

三、AlertDialog的高級用法

除了基礎的設置外，AlertDialog還提供了很多高級用法，可以滿足更加靈活的需要。下面我們將逐一講解。

1. 自定義Dialog樣式

我們可以通過style.xml文件來自定義AlertDialog的樣式，包括背景色、按鈕顏色、文本顏色等。示例代碼如下：

<style name="MyAlertDialogStyle" parent="@android:style/Theme.Dialog">
    <item name="android:background">#ffffff</item>
    <item name="android:textColor">#333333</item>
    <item name="android:buttonStyle">@style/MyButtonStyle</item>
    ...
</style>

<style name="MyButtonStyle" parent="@android:style/Widget.Button">
    <item name="android:background">#4286f4</item>
    <item name="android:textColor">#ffffff</item>
    ...
</style>

使用自定義的樣式

AlertDialog.Builder builder = new AlertDialog.Builder(this, R.style.MyAlertDialogStyle);

2. 自定義Dialog的寬度和高度

我們可以通過在AlertDialog.Builder中調用setView()方法設置一個View時，獲取到該View並通過設置其LayoutParams來實現彈窗的自定義寬度和高度。示例代碼如下：

View view = LayoutInflater.from(this).inflate(R.layout.custom_layout, null);
AlertDialog dialog = new AlertDialog.Builder(this)
        .setView(view)
        .create();
Window window = dialog.getWindow();
if (window != null) {
    WindowManager.LayoutParams layoutParams = window.getAttributes();
    layoutParams.width = 800;
    layoutParams.height = 600;
    window.setAttributes(layoutParams);
}

3. 設置自定義動畫

我們可以通過在AlertDialog.Builder中調用setView()方法設置一個View時，獲取到該View並通過設置其LayoutParams來實現彈窗的自定義動畫。示例代碼如下：

View view = LayoutInflater.from(this).inflate(R.layout.custom_layout, null);
AlertDialog dialog = new AlertDialog.Builder(this)
        .setView(view)
        .create();
Window window = dialog.getWindow();
if (window != null) {
    window.setWindowAnimations(R.style.myAnimation);
}

結語

本篇文章詳細介紹了AlertDialog的基礎用法和高級用法，並給出了代碼示例。讀者可以根據自己的需要進行調整和擴展，實現更加豐富、靈活的AlertDialog交互體驗。