Android技术问题：Popup Menu触发后退出沉浸模式，菜单项被导航栏遮挡

我完全懂你这种被系统UI行为坑到的感受——沉浸模式下好好的界面，一弹PopupMenu就把导航栏搞出来，最后一个菜单项还跑到导航栏下面，点击全白费，太闹心了。结合你的场景，给你几个可行的解决方案：

方案一：用PopupWindow替代PopupMenu（最可靠） #

PopupMenu的系统默认行为很难完全控制，换成PopupWindow能自定义更多细节，完美避开沉浸模式和遮挡问题：

1. 先创建一个菜单布局文件（比如popup_notification_menu.xml），把原来的菜单项都放进去：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:orientation="vertical"
    android:background="@drawable/popup_bg">

    <TextView
        android:id="@+id/menu_item1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:padding="16dp"
        android:text="菜单项1"/>

    <!-- 其他菜单项依次添加 -->
</LinearLayout>

2. 在代码里初始化并显示PopupWindow，同时处理沉浸模式和位置：

notificationSchedule.setOnClickListener(v -> {
    // 加载自定义菜单布局
    View popupView = LayoutInflater.from(requireActivity()).inflate(R.layout.popup_notification_menu, null);
    
    // 创建PopupWindow，设置大小和外部点击关闭
    PopupWindow popupWindow = new PopupWindow(popupView, 
            ViewGroup.LayoutParams.WRAP_CONTENT, 
            ViewGroup.LayoutParams.WRAP_CONTENT, 
            true);
    
    // 设置背景（必须设置，否则外部点击关闭可能失效）
    popupWindow.setBackgroundDrawable(new ColorDrawable(Color.TRANSPARENT));
    
    // 关键：设置PopupWindow的显示位置，让它避开导航栏
    int[] location = new int[2];
    v.getLocationOnScreen(location);
    popupWindow.showAtLocation(v, Gravity.TOP | Gravity.END, 
            getResources().getDimensionPixelSize(R.dimen.popup_right_margin), 
            location[1] + v.getHeight());
    
    // 重新锁定沉浸模式，防止导航栏弹出
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
        requireActivity().getWindow().getInsetsController().hide(WindowInsets.Type.navigationBars());
        requireActivity().getWindow().getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
    } else {
        requireActivity().getWindow().getDecorView().setSystemUiVisibility(
                View.SYSTEM_UI_FLAG_HIDE_NAVIGATION | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
    }
    
    // 设置菜单项点击事件，这里可以模仿原来的SpannableString逻辑
    TextView item1 = popupView.findViewById(R.id.menu_item1);
    if (databaseNotification.getIndex1() == 0) {
        SpannableString spannable = new SpannableString(item1.getText());
        spannable.setSpan(new ForegroundColorSpan(getResources().getColor(R.color.colorPrimary)), 
                0, spannable.length(), 0);
        item1.setText(spannable);
    }
    item1.setOnClickListener(itemView -> {
        // 处理点击逻辑
        managePopupMenuClick(-1, null); // 这里根据实际情况调整参数
        popupWindow.dismiss();
    });
    
    // 其他菜单项同理设置
});

这个方案的好处是完全掌控Popup的位置和系统UI行为，再也不会出现导航栏乱弹或者菜单项被遮挡的问题。

方案二：修复原生PopupMenu的问题（如果不想换PopupWindow） #

如果坚持用PopupMenu，可以尝试以下两个调整：

1. 强制PopupMenu不延伸到导航栏下方 #

在显示PopupMenu前，设置它的布局参数，限制其最大高度：

notificationMenu.setOnShowListener(menu -> {
    // 获取PopupMenu的弹窗布局
    View popupView = ((ViewGroup) notificationMenu.getMenuInflater().getContext().findViewById(com.android.internal.R.id.popup_menu)).getChildAt(0);
    if (popupView != null) {
        // 获取屏幕可用高度（减去导航栏高度）
        DisplayMetrics metrics = new DisplayMetrics();
        requireActivity().getWindowManager().getDefaultDisplay().getMetrics(metrics);
        int navBarHeight = getNavigationBarHeight();
        int maxHeight = metrics.heightPixels - navBarHeight - v.getTop() - v.getHeight();
        
        // 设置PopupMenu的最大高度
        popupView.getLayoutParams().height = Math.min(popupView.getLayoutParams().height, maxHeight);
        popupView.requestLayout();
    }
});

// 辅助方法：获取导航栏高度
private int getNavigationBarHeight() {
    int resourceId = getResources().getIdentifier("navigation_bar_height", "dimen", "android");
    if (resourceId > 0) {
        return getResources().getDimensionPixelSize(resourceId);
    }
    return 0;
}

2. 显示PopupMenu后立即恢复沉浸模式 #

替换你原来的OnSystemUiVisibilityChangeListener，用更可靠的WindowInsetsController（针对Android 11+）：

notificationMenu.show();

// 立即恢复沉浸模式
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    WindowInsetsController insetsController = requireActivity().getWindow().getInsetsController();
    if (insetsController != null) {
        insetsController.hide(WindowInsets.Type.navigationBars());
        insetsController.setSystemBarsBehavior(WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE);
    }
} else {
    requireActivity().getWindow().getDecorView().setSystemUiVisibility(
            View.SYSTEM_UI_FLAG_HIDE_NAVIGATION | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
}

这样能在PopupMenu弹出后快速把导航栏隐藏回去，同时限制PopupMenu的高度，不让最后一个菜单项跑到导航栏下面。

补充说明 #

你之前尝试的setOnSystemUiVisibilityChangeListener在Android 10及以上版本效果不好，因为系统对沉浸式模式的处理逻辑变了，改用WindowInsetsController是更现代的做法。另外，限制PopupMenu的可见数量其实没必要，只要控制好它的最大高度，超出部分会自动滚动，用户就能正常点击所有菜单项了。

内容的提问来源于stack exchange，提问作者Veselin Zinkov