萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 對話框完整開發指南:從 AlertDialog 到自定義佈局

為什麼需要對話框?

對話框是移動應用中與使用者進行關鍵互動的核心 UI 元件:確認刪除操作、輸入敏感資訊、顯示載入進度、引導新手教學等。Android 提供了靈活的 AlertDialog 體系,支援從簡單的訊息提示到複雜的自定義佈局。

標準 AlertDialog 建立流程(六步驟)

  1. 建立 Builder: AlertDialog.Builder builder = new AlertDialog.Builder(context);
  2. 設定標題: builder.setTitle("標題") 或 setCustomTitle(View) 使用自定義標題佈局。
  3. 設定圖示: builder.setIcon(R.drawable.ic_info)。
  4. 設定內容:
    • 純文字:setMessage("內容文字")
    • 列表選項:setItems(items, listener) / setSingleChoiceItems() / setMultiChoiceItems()
    • 自定義 View:setView(View)(最常用於複雜表單)
  5. 添加按鈕:
    • 確定:setPositiveButton("確定", listener)
    • 取消:setNegativeButton("取消", listener)
    • 中立:setNeutralButton("稍後", listener)
  6. 顯示對話框: AlertDialog dialog = builder.create(); dialog.show();

進階技巧與常見坑點

1. 防止對話框意外關閉

dialog.setCanceledOnTouchOutside(false); // 點擊外部不關閉
dialog.setCancelable(false); // 返回鍵不關閉

2. 自定義佈局完整範例

res/layout/dialog_login.xml

<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical"
    android:padding="24dp">
    <EditText android:id="@+id/et_account"
        android:hint="帳號" android:inputType="textEmailAddress" />
    <EditText android:id="@+id/et_password"
        android:hint="密碼" android:inputType="textPassword" />
</LinearLayout>

Java/Kotlin 調用

View view = LayoutInflater.from(context).inflate(R.layout.dialog_login, null);
EditText etAccount = view.findViewById(R.id.et_account);
EditText etPassword = view.findViewById(R.id.et_password);

new AlertDialog.Builder(context)
    .setTitle("登入")
    .setView(view)
    .setPositiveButton("登入", (d, w) -> {
        String account = etAccount.getText().toString();
        String pwd = etPassword.getText().toString();
        // TODO: 驗證邏輯
    })
    .setNegativeButton("取消", null)
    .show();

3. DialogFragment:生命週期安全的選擇

直接使用 AlertDialog 在 Activity 重建(如旋轉螢幕)時易導致洩漏或崩潰。DialogFragment 由 FragmentManager 管理,能自動處理狀態保存與恢復。

public class LoginDialogFragment extends DialogFragment {
    @NonNull
    @Override
    public Dialog onCreateDialog(Bundle savedInstanceState) {
        View view = LayoutInflater.from(getContext()).inflate(R.layout.dialog_login, null);
        // ... 綁定 View 與邏輯
        return new AlertDialog.Builder(requireContext())
            .setTitle("登入")
            .setView(view)
            .setPositiveButton("登入", (d, w) -> { /* ... */ })
            .setNegativeButton("取消", null)
            .create();
    }
}
// 顯示方式
new LoginDialogFragment().show(getSupportFragmentManager(), "login_dialog");

4. MaterialAlertDialog (Material Components)

引入 com.google.android.material:material:1.6.0+ 後,建議使用 MaterialAlertDialogBuilder,自動適配 Material Design 3 風格(圓角、色調、動畫)。

new MaterialAlertDialogBuilder(context, R.style.ThemeOverlay_App_MaterialAlertDialog)
    .setTitle("Material 風格")
    .setMessage("自動適配深色模式與動態色彩")
    .show();

5. 底部彈出表單

若需從底部滑入的選單(如分享面板),請使用 BottomSheetDialogFragment,體驗更符合現代 Android 設計規範。

總結

掌握 AlertDialog.Builder 的六步驟流程是基礎,善用 setView() 實現自定義佈局、改用 DialogFragment 管理生命週期、遷移至 MaterialAlertDialogBuilder 獲得現代視覺一致性,是開發高品質 Android 對話框的關鍵進階路徑。

copyright © 萬盛學電腦網 all rights reserved