Edge-to-Edge模式下三键导航栏可见性问题求助

1. 正确配置系统UI控制器 #

在Activity的onCreate方法中，完成Edge-to-Edge设置后，通过WindowInsetsControllerCompat明确设置导航栏图标的明暗模式，确保和应用背景形成对比：

Kotlin 代码示例：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 开启Edge-to-Edge
    WindowCompat.setDecorFitsSystemWindows(window, false)
    // 获取系统UI控制器
    val insetsController = WindowInsetsControllerCompat(window, window.decorView)
    // 根据应用背景色设置图标明暗：背景浅色设为true，深色设为false
    insetsController.isAppearanceLightNavigationBars = false
}

Java 代码示例：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    WindowCompat.setDecorFitsSystemWindows(getWindow(), false);
    WindowInsetsControllerCompat insetsController = new WindowInsetsControllerCompat(getWindow(), getWindow().getDecorView());
    insetsController.setAppearanceLightNavigationBars(false);
}

2. 调整主题导航栏属性 #

在themes.xml中，确保导航栏配置不覆盖系统对比逻辑：

<!-- 保持导航栏透明，让系统自动处理背景对比 -->
<item name="android:navigationBarColor">@android:color/transparent</item>
<!-- 强制启用导航栏对比 -->
<item name="android:enforceNavigationBarContrast">true</item>
<!-- 可选：添加导航栏分隔线，增强与内容区的区分 -->
<item name="android:navigationBarDividerColor">?android:attr/colorSurface</item>

注意：不要硬设置navigationBarColor为和应用背景完全一致的颜色，否则系统无法生成有效对比。

3. 适配低版本Android #

对于Android 9（API 28）及以下版本，系统不支持enforceNavigationBarContrast，需要手动配置：

<!-- 设置导航栏背景色 -->
<item name="android:navigationBarColor">@color/nav_bar_contrast_color</item>
<!-- 设置导航栏图标为浅色/深色 -->
<item name="android:windowLightNavigationBar">true</item>

内容的提问来源于stack exchange，提问作者Cheok Yan Cheng