Modal BottomSheet滑动时显示于导航栏前方的修复方案咨询

这个问题我之前也碰到过，本质是默认的BottomSheetDialog没有适配系统导航栏的沉浸式布局，导致弹窗的显示范围被限制在导航栏上方，滑动时自然就会直接出现在导航栏前面，视觉效果很生硬。下面是具体的修复步骤：

1. 重写onCreateDialog配置Dialog的Window属性 #

在你的ExampleBottomSheetDialog类里新增onCreateDialog方法，让弹窗的Window延伸到系统导航栏下方，并设置导航栏透明：

@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
    BottomSheetDialog dialog = (BottomSheetDialog) super.onCreateDialog(savedInstanceState);
    
    // 设置弹窗显示时的回调，用来调整BottomSheet的高度
    dialog.setOnShowListener(dialogInterface -> {
        BottomSheetDialog bottomSheetDialog = (BottomSheetDialog) dialogInterface;
        setupFullHeight(bottomSheetDialog);
    });
    
    // 关键：让Window延伸到导航栏下方，同时设置导航栏透明
    if (dialog.getWindow() != null) {
        dialog.getWindow().setFlags(
            WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS,
            WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS
        );
        dialog.getWindow().setNavigationBarColor(Color.TRANSPARENT);
        // 如果需要状态栏也透明，可以加上下面这行
        // dialog.getWindow().setStatusBarColor(Color.TRANSPARENT);
    }
    
    return dialog;
}

2. 添加方法设置BottomSheet全屏高度 #

上面的回调里用到了setupFullHeight方法，用来让BottomSheet的高度适配全屏，这样滑动时就能从屏幕最底部（包括导航栏下方）升起：

private void setupFullHeight(BottomSheetDialog bottomSheetDialog) {
    FrameLayout bottomSheet = bottomSheetDialog.findViewById(com.google.android.material.R.id.design_bottom_sheet);
    if (bottomSheet != null) {
        CoordinatorLayout.LayoutParams layoutParams = (CoordinatorLayout.LayoutParams) bottomSheet.getLayoutParams();
        // 设置高度为全屏
        layoutParams.height = ViewGroup.LayoutParams.MATCH_PARENT;
        bottomSheet.setLayoutParams(layoutParams);
        
        // 配置BottomSheetBehavior，优化滑动表现
        BottomSheetBehavior<FrameLayout> behavior = BottomSheetBehavior.from(bottomSheet);
        // 允许BottomSheet展开到全屏
        behavior.setFitToContents(false);
        // 默认折叠状态（也可以设置为STATE_EXPANDED直接全屏显示）
        behavior.setState(BottomSheetBehavior.STATE_COLLAPSED);
    }
}

3. 调整布局文件的fitsSystemWindows属性 #

打开你的bottom_sheet_layout.xml，确保根布局的fitsSystemWindows设置为false，避免系统自动添加padding导致内容被导航栏遮挡：

<!-- 根布局示例 -->
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:fitsSystemWindows="false"
    android:orientation="vertical"
    android:padding="16dp">
    
    <!-- 你的按钮和其他内容 -->
    <Button
        android:id="@+id/button1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Button 1"/>
        
    <Button
        android:id="@+id/button2"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Button 2"/>
</LinearLayout>

4. 确保Activity主题支持沉浸式 #

检查你的App主题（一般在styles.xml里），添加以下属性来支持导航栏透明和沉浸式布局：

<style name="AppTheme" parent="Theme.MaterialComponents.Light.NoActionBar">
    <!-- 其他已有的主题属性 -->
    <item name="android:windowTranslucentNavigation">true</item>
    <item name="android:windowDrawsSystemBarBackgrounds">true</item>
</style>

做完这些设置后，你的BottomSheetDialogFragment在滑动升起时就会从导航栏后方滑出，完全展开后也会自然覆盖在导航栏上方，视觉流畅度会好很多。

内容的提问来源于stack exchange，提问作者Florian Walther