對話框是移動應用中與使用者進行關鍵互動的核心 UI 元件:確認刪除操作、輸入敏感資訊、顯示載入進度、引導新手教學等。Android 提供了靈活的 AlertDialog 體系,支援從簡單的訊息提示到複雜的自定義佈局。
AlertDialog.Builder builder = new AlertDialog.Builder(context);builder.setTitle("標題") 或 setCustomTitle(View) 使用自定義標題佈局。builder.setIcon(R.drawable.ic_info)。setMessage("內容文字")setItems(items, listener) / setSingleChoiceItems() / setMultiChoiceItems()setView(View)(最常用於複雜表單)setPositiveButton("確定", listener)setNegativeButton("取消", listener)setNeutralButton("稍後", listener)AlertDialog dialog = builder.create(); dialog.show();dialog.setCanceledOnTouchOutside(false); // 點擊外部不關閉
dialog.setCancelable(false); // 返回鍵不關閉
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();
直接使用 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");
引入 com.google.android.material:material:1.6.0+ 後,建議使用 MaterialAlertDialogBuilder,自動適配 Material Design 3 風格(圓角、色調、動畫)。
new MaterialAlertDialogBuilder(context, R.style.ThemeOverlay_App_MaterialAlertDialog)
.setTitle("Material 風格")
.setMessage("自動適配深色模式與動態色彩")
.show();
若需從底部滑入的選單(如分享面板),請使用 BottomSheetDialogFragment,體驗更符合現代 Android 設計規範。
掌握 AlertDialog.Builder 的六步驟流程是基礎,善用 setView() 實現自定義佈局、改用 DialogFragment 管理生命週期、遷移至 MaterialAlertDialogBuilder 獲得現代視覺一致性,是開發高品質 Android 對話框的關鍵進階路徑。