Android Fragment实现全屏隐藏系统栏的最新正确方法

DevOps 小满

2026-8-15

Fragment全屏实现（最新兼容方案）

你当前使用的FLAG_LAYOUT_NO_LIMITS仅能让布局延伸至系统栏下方，无法主动隐藏状态栏和导航栏，这是导致效果不符合预期的原因。以下是基于Jetpack WindowInsetsControllerCompat的最新实现方案，兼容Android 11及以上版本，同时向下兼容低版本：

实现步骤

确保项目已引入AndroidX核心库（常规AndroidX项目默认包含）
在Fragment中添加如下代码：

import androidx.core.view.WindowInsetsControllerCompat
import androidx.core.view.WindowInsetsCompat

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    val window = requireActivity().window
    val insetsController = WindowInsetsControllerCompat(window, view)

    // 隐藏状态栏和导航栏
    insetsController.hide(WindowInsetsCompat.Type.systemBars())
    // 设置滑动边缘调出系统栏后自动隐藏的粘性沉浸式模式
    insetsController.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
}

override fun onDestroyView() {
    super.onDestroyView()
    val window = requireActivity().window
    val insetsController = WindowInsetsControllerCompat(window, requireView())

    // 恢复系统栏显示，避免影响其他页面
    insetsController.show(WindowInsetsCompat.Type.systemBars())
}

关键说明

WindowInsetsControllerCompat是官方推荐的替代旧SYSTEM_UI_FLAG系列常量的API，彻底解决了旧方法废弃的问题
BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE模式下，用户滑动屏幕边缘可临时调出系统栏，松开后系统栏会自动隐藏，保持全屏体验
如果需要布局在系统栏显示时也完全覆盖（即系统栏透明叠加在布局上），可额外添加：
```
window.addFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS)
```
并在onDestroyView中清除该flag：
```
window.clearFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS)
```