Dialog 持有焦點時,Activity 的 onKeyDown/onBackPressed 無法接收 Back 鍵事件。本文對比三種攔截方案:Dialog.setOnCancelListener、Dialog.setOnKeyListener、Activity.dispatchKeyEvent,並給出最佳實踐代碼模板。
Dialog 彈出後成為焦點窗口,Back 鍵事件先分發給 Dialog,Dialog 默認行為:cancel() → 觸發 OnCancelListener → 關閉 Dialog。Activity 不再收到事件。
AlertDialog dialog = new AlertDialog.Builder(this)
.setTitle("標題")
.setMessage("內容")
.setPositiveButton("確定", null)
.setNegativeButton("取消", null)
.create();
dialog.setOnCancelListener(dialogInterface -> {
// 用戶按 Back 鍵、或調用 dialog.cancel() 觸發
Log.d("Dialog", "Back pressed or cancelled");
// 執行自定義邏輯:埋點、狀態恢復、防止重複提交等
onDialogCancelled();
});
dialog.show();
setCanceledOnTouchOutside(true))。dialog.setOnKeyListener((dialogInterface, keyCode, event) -> {
if (keyCode == KeyEvent.KEYCODE_BACK && event.getAction() == KeyEvent.ACTION_DOWN) {
// 可在此判斷是否允許關閉
if (hasUnsavedChanges()) {
showSaveConfirmDialog(); // 彈出二次確認
return true; // 消費事件,Dialog 不關閉
}
// 允許關閉,返回 false 讓 Dialog 繼續處理
}
return false;
});
dialog.dismiss()。event.getAction() 避免重複處理 Down/Up,return true 會阻斷所有後續處理 (含 Accessibility)。@Override
public boolean dispatchKeyEvent(KeyEvent event) {
if (event.getKeyCode() == KeyEvent.KEYCODE_BACK && event.getAction() == KeyEvent.ACTION_DOWN) {
if (currentDialog != null && currentDialog.isShowing()) {
// 委託給 Dialog 的 OnKeyListener,或直接處理
return currentDialog.onKeyDown(keyCode, event); // 需 Dialog 繼承實現
}
}
return super.dispatchKeyEvent(event);
}
public abstract class BaseDialogFragment extends DialogFragment {
private OnBackPressListener backPressListener;
public interface OnBackPressListener {
/** @return true 消費事件阻止關閉,false 允許關閉 */
boolean onBackPressed();
}
public void setOnBackPressListener(OnBackPressListener listener) {
this.backPressListener = listener;
}
@NonNull @Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
AlertDialog dialog = (AlertDialog) super.onCreateDialog(savedInstanceState);
dialog.setOnKeyListener((d, keyCode, event) -> {
if (keyCode == KeyEvent.KEYCODE_BACK && event.getAction() == KeyEvent.ACTION_DOWN) {
if (backPressListener != null) {
return backPressListener.onBackPressed();
}
}
return false;
});
return dialog;
}
}
// 使用
MyDialogFragment fragment = new MyDialogFragment();
fragment.setOnBackPressListener(() -> {
if (hasUnsavedData()) {
showSaveDialog();
return true; // 阻止關閉
}
return false; // 允許關閉
});
fragment.show(getSupportFragmentManager(), "tag");
| 需求 | 推薦方案 |
|---|---|
| 單純執行取消邏輯 (埋點、清理) | OnCancelListener |
| 需阻止關閉 (未保存提示、二次確認) | OnKeyListener + return true |
| 全局統一處理、第三方 Dialog | Activity.dispatchKeyEvent |
| DialogFragment 體系、可複用 | 基類封裝 OnKeyListener |
根據業務語義選擇方案:取消語義用 OnCancelListener,攔截阻止語義用 OnKeyListener,避免濫用 dispatchKeyEvent 導致事件分發混亂。