如何在Jetpack Compose中实现Navigation bar完全透明？

问题说明 #

需要实现Navigation Bar完全透明，但当前仅能将导航栏变为白色，且底部UI存在部分裁剪：
当前效果截图
当前使用的代码：
当前代码截图

解决方案 #

1. 主题核心配置

在themes.xml/styles.xml中修改主题属性，直接设置导航栏透明并允许布局延伸：

<style name="YourAppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
    <!-- 设置导航栏完全透明 -->
    <item name="android:navigationBarColor">@android:color/transparent</item>
    <!-- 允许窗口绘制系统栏背景，关闭半透明导航栏模式 -->
    <item name="android:windowDrawsSystemBarBackgrounds">true</item>
    <item name="android:windowTranslucentNavigation">false</item>
    <!-- 根据页面背景设置导航栏图标颜色，避免图标不可见 -->
    <item name="android:navigationBarIconColor">@color/your_target_icon_color</item>
    <!-- API29+机型可关闭强制对比度，确保透明生效 -->
    <item name="android:enforceNavigationBarContrast">false</item>
</style>

2. 布局适配解决底部裁剪

原生View方案

两种方式二选一即可：

• 动态给根布局添加导航栏高度内边距：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 让布局延伸到导航栏下方
    window.setFlags(
        WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS,
        WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS
    )
    setContentView(R.layout.your_activity_layout)

    // 获取导航栏高度，设置底部内边距
    val navBarHeight = resources.getDimensionPixelSize(
        resources.getIdentifier("navigation_bar_height", "dimen", "android")
    )
    findViewById<View>(android.R.id.content).setPadding(0, 0, 0, navBarHeight)
}

• XML根布局开启fitsSystemWindows：

<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true">

    <!-- 你的页面内容 -->
</androidx.constraintlayout.widget.ConstraintLayout>

Jetpack Compose方案

直接给Scaffold或根布局添加导航栏内边距适配：

Scaffold(
    modifier = Modifier.navigationBarsPadding()
) { paddingValues ->
    // 页面内容使用paddingValues.bottom避免被裁剪
    Column(modifier = Modifier.padding(paddingValues)) {
        // ...你的Compose内容
    }
}

3. 常见坑排查

• 不要同时设置windowTranslucentNavigation=true和navigationBarColor=transparent，会导致半透明阴影残留；
• 确保没有其他全屏/隐藏导航栏的逻辑干扰当前配置；
• 部分定制ROM可能需要额外适配，可测试后调整navigationBarIconColor确保图标可见。

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