本文首发于公众号“AntDream”，欢迎微信搜索“AntDream”或扫描文章底部二维码关注，和我一起每天进步一点点
WindowInsetsControllerCompat 是 Android 中的一个类，用于更方便地处理和控制窗口插入 (Window Insets)，例如状态栏和导航栏的显示和隐藏。这个类是 Android 视图系统的一部分，提供了对窗口内嵌元素的更现代和灵活的控制方法。
这是一个位于 androidx.core.view 包中的类，旨在增强对不同 Android 版本的兼容性。它简化了在不同 API 级别上控制系统窗口插入的复杂性，使得开发者能够更轻松地处理状态栏和导航栏的显示/隐藏、动画过渡等操作。
主要功能
1、 显示和隐藏状态栏、导航栏：
使用 WindowInsetsControllerCompat，你可以轻松地控制状态栏和导航栏的显示与隐藏。
2、 控制系统窗口的行为：
你可以控制系统窗口的行为模式，例如 BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE，允许用户通过滑动手势临时显示系统栏。
3、 设置系统窗口插入的样式：
例如，可以设置状态栏和导航栏的亮色或暗色（浅色主题下的深色文本和图标，或者深色主题下的浅色文本和图标）。
代码示例
下面通过 Kotlin 代码示例展示如何使用 WindowInsetsControllerCompat 来实现上述功能。
初始化 WindowInsetsControllerCompat
首先，我们需要初始化 WindowInsetsControllerCompat。这通常是在 Activity 或者 Fragment 中完成的。
import androidx.core.view.WindowInsetsCompat
import androidx.core.view.WindowInsetsControllerCompat
val windowInsetsController = WindowInsetsControllerCompat(window, window.decorView)
隐藏状态栏和导航栏
通过设置 WindowInsetsCompat.Type.statusBars() 和 WindowInsetsCompat.Type.navigationBars() 可以控制状态栏和导航栏的显示和隐藏。
windowInsetsController.hide(WindowInsetsCompat.Type.statusBars())
windowInsetsController.hide(WindowInsetsCompat.Type.navigationBars())
显示状态栏和导航栏
同样，我们可以通过以下代码来显示状态栏和导航栏。
windowInsetsController.show(WindowInsetsCompat.Type.statusBars())
windowInsetsController.show(WindowInsetsCompat.Type.navigationBars())
设置系统窗口行为
你可以使用 WindowInsetsControllerCompat 来设置系统窗口的显示行为。例如，可以设置系统栏在滑动手势下显示。
windowInsetsController.systemBarsBehavior =
WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
WindowInsetsControllerCompat 的 Behavior 标志位
WindowInsetsControllerCompat 的 systemBarsBehavior 属性决定了系统栏（状态栏和导航栏）在隐藏和显示时的行为。主要有三个常量可用：
1、 BEHAVIOR_SHOW_BARS_BY_SWIPE（滑动显示系统栏）：
- 当系统栏隐藏时，用户可以通过从系统栏区域向内滑动来显示。
它是API 21（Lollipop）及以上的默认行为。
windowInsetsController.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_BARS_BY_SWIPE
2、 BEHAVIOR_SHOW_BARS_BY_TOUCH（触摸显示系统栏）：
当系统栏隐藏时，用户可以通过触摸屏幕的任意位置来显示系统栏。这个行为可能导致误触。
windowInsetsController.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_BARS_BY_TOUCH
3、 BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE（滑动显示临时系统栏）：
当系统栏隐藏时，用户可以通过从系统栏区域向内滑动来临时显示系统栏。几秒钟后系统栏会自动隐藏。
windowInsetsController.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
设置状态栏和导航栏的颜色样式
你可以设置状态栏和导航栏的颜色样式（亮色或暗色），以便在不同主题下提供更好的用户体验。
windowInsetsController.isAppearanceLightStatusBars = true // 状态栏使用亮色样式
windowInsetsController.isAppearanceLightNavigationBars = true // 导航栏使用亮色样式
示例：简单的 Activity
下面是一个完整的 Activity 示例，展示了如何初始化和使用 WindowInsetsControllerCompat。
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import androidx.core.view.WindowCompat
import androidx.core.view.WindowInsetsCompat
import androidx.core.view.WindowInsetsControllerCompat
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
// Initialize the WindowInsetsControllerCompat
val windowInsetsController = WindowInsetsControllerCompat(window, window.decorView)
// Hide status bar and navigation bar
windowInsetsController.hide(WindowInsetsCompat.Type.statusBars())
windowInsetsController.hide(WindowInsetsCompat.Type.navigationBars())
// Set behavior to show transient bars by swipe
windowInsetsController.systemBarsBehavior =
WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
// Set light status bar and navigation bar appearance
windowInsetsController.isAppearanceLightStatusBars = true
windowInsetsController.isAppearanceLightNavigationBars = true
}
}
总结
WindowInsetsControllerCompat 为开发者提供了一种建议使用的方式来处理和控制 Android 系统的窗口插入。与传统方法相比，它更现代、更灵活，同时也更兼容不同的 Android 版本。因此，在处理状态栏、导航栏的显示和样式时，建议使用 WindowInsetsControllerCompat。
欢迎关注我的公众号AntDream查看更多精彩文章！
