Android设置windowTranslucentNavigation后视图被导航栏遮挡如何解决

问题现象 #

开启android:windowTranslucentNavigation属性后，页面内容默认会延伸到导航栏下方，出现固定内容被导航栏遮挡的问题，效果如下：

核心思路 #

同时满足半透明导航栏视觉效果、固定内容不被遮挡、可滚动内容可延伸至导航栏区域的需求，核心是通过*系统窗口插入项（WindowInsets）*动态控制不同类型视图的padding，配合滚动容器的clipToPadding特性实现。

分步实现方案 #

• 第一步：主题配置补充
  除你已添加的半透明导航栏属性外，在对应Activity的主题中新增属性，关闭系统默认的窗口适配逻辑：

  <item name="android:fitsSystemWindows">false</item>
  

• 第二步：布局结构调整
  页面根布局选用ConstraintLayout或CoordinatorLayout，将可滚动容器（RecyclerView/NestedScrollView等）与固定非滚动元素分开布局，同时给滚动容器添加clipToPadding=false属性，允许内容在padding区域显示：

  <androidx.constraintlayout.widget.ConstraintLayout
      xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:app="http://schemas.android.com/apk/res-auto"
      android:layout_width="match_parent"
      android:layout_height="match_parent">
  
      <!-- 可滚动内容 -->
      <androidx.recyclerview.widget.RecyclerView
          android:id="@+id/recyclerView"
          android:layout_width="match_parent"
          android:layout_height="match_parent"
          android:clipToPadding="false"
          app:layout_constraintTop_toTopOf="parent"
          app:layout_constraintBottom_toBottomOf="parent"/>
  
      <!-- 固定底部的非滚动控件 -->
      <Button
          android:id="@+id/confirmBtn"
          android:layout_width="match_parent"
          android:layout_height="wrap_content"
          app:layout_constraintBottom_toBottomOf="parent"
          android:text="确认操作"/>
  </androidx.constraintlayout.widget.ConstraintLayout>
  

• 第三步：动态适配导航栏高度
  在Activity的onCreate生命周期中监听WindowInsets，获取导航栏高度后分别给固定控件和滚动容器设置底部padding：

  ViewCompat.setOnApplyWindowInsetsListener(window.decorView) { _, insets ->
      // 获取导航栏高度
      val navBarHeight = insets.getInsets(WindowInsetsCompat.Type.navigationBars()).bottom
      // 固定控件添加底部padding，避免被导航栏遮挡
      binding.confirmBtn.setPadding(0, 0, 0, navBarHeight)
      // 滚动容器添加底部padding，滚动到底部时内容不会被导航栏遮挡
      binding.recyclerView.setPadding(0, 0, 0, navBarHeight)
      insets
  }
  

最终效果 #

• 页面内容不足一屏无滚动空间时，所有内容都展示在导航栏上方，不会出现遮挡
• 页面内容超出一屏可滚动时，滚动内容可延伸到半透明导航栏区域显示，滚动到底部时内容末尾刚好在导航栏上方，完全可见

注意事项 #

• 不要给根布局设置fitsSystemWindows=true，否则系统会自动给根布局添加全局padding，无法单独控制不同元素的适配逻辑
• 无滚动内容的普通页面可直接给根布局设置等于导航栏高度的底部padding，无需额外处理滚动逻辑

内容的提问来源于stack exchange，提问作者Real Tech Hacks