Android自定義Dialog位置調整受限問題：改用PopupWindow實現頂部對齊

現象描述

自定義 `Dialog`/`AlertDialog` 默認顯示在標題欄（ActionBar/StatusBar）下方，嘗試設置 `layoutParams.y = -50` 等負值向上偏移無效，`getWindow().setGravity(Gravity.TOP)` 也無法突破標題欄限制。

根本原因

`Dialog` 依附於 `Window`，其 `WindowManager.LayoutParams` 的 `y` 坐標在 `PhoneWindow` 內部會被修正：最小值為標題欄高度。這是系統為了保證 Dialog 不遮擋狀態欄/導航欄的安全機制，不可繞過。

解決方案：使用 PopupWindow

`PopupWindow` 是浮動容器，不受標題欄約束，可精確控制屏幕任意座標顯示。

核心代碼

public class TopAlignedPopup {
    private PopupWindow popupWindow;
    private View contentView;

    public TopAlignedPopup(Context context) {
        // 1. 加載佈局
        contentView = LayoutInflater.from(context).inflate(R.layout.popup_top, null);
        
        // 2. 初始化 PopupWindow (寬高自適應)
        popupWindow = new PopupWindow(contentView, 
            ViewGroup.LayoutParams.MATCH_PARENT, 
            ViewGroup.LayoutParams.WRAP_CONTENT, 
            true); // focusable = true 允許外部點擊消失
        
        // 3. 關鍵：設置背景才能響應外部點擊消失
        popupWindow.setBackgroundDrawable(new ColorDrawable(Color.TRANSPARENT));
        
        // 4. 可選：動畫
        popupWindow.setAnimationStyle(R.style.PopupAnimation_Top);
    }

    // 顯示在屏幕頂部 (0,0)
    public void showAtTop(View anchor) {
        // anchor 可為任意 View，僅用於獲取 WindowToken
        popupWindow.showAtLocation(anchor, Gravity.TOP | Gravity.START, 0, 0);
    }

    // 顯示在指定座標
    public void showAtLocation(View anchor, int x, int y) {
        popupWindow.showAtLocation(anchor, Gravity.NO_GRAVITY, x, y);
    }

    public void dismiss() {
        if (popupWindow != null && popupWindow.isShowing()) {
            popupWindow.dismiss();
        }
    }
}

佈局文件

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical"
    android:background="@android:color/white"
    android:elevation="8dp"> <!-- 陰影 -->
    
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="頂部對齊彈窗"
        android:padding="16dp"
        android:gravity="center"
        android:textSize="16sp" />
        
    <Button
        android:id="@+id/btn_close"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="關閉" />
</LinearLayout>

調用示例

TopAlignedPopup popup = new TopAlignedPopup(this);
popup.showAtTop(findViewById(android.R.id.content)); // 以根佈局為錨點
contentView.findViewById(R.id.btn_close).setOnClickListener(v -> popup.dismiss());

Dialog vs PopupWindow 選型對比

避坑指南

• ⚠️ `PopupWindow` 必須 `setBackgroundDrawable` (哪怕透明)，否則 `setOutsideTouchable(true)` 不生效，無法點擊外部關閉。
• ⚠️ Android 7.0+ `showAtLocation` 坐標偏移 Bug，建議用 `showAsDropDown(anchor, xOff, yOff, gravity)` 或計算屏幕座標後用 `Gravity.NO_GRAVITY`。
• ⚠️ 生命周期：`onPause`/`onDestroy` 時必須 `dismiss()`，否則 `WindowLeaked` 崩潰。
• ⚠️ 針對「類 Dialog」體驗，可封裝 `PopupWindow` 為 `Dialog` 風格 API (如 `PopupDialog` 库)。

總結

Dialog 位置受限於系統窗口裝飾，**需頂部貼邊/任意座標時請直接用 PopupWindow**。封裝通用 `PopupHelper` 管理生命周期、動畫、輸入法、模態遮罩，即可獲得比 Dialog 更靈活、更強大的浮動交互能力。