本文首发于公众号“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)
  • 1.
  • 2.
  • 3.
  • 4.
隐藏状态栏和导航栏

通过设置 WindowInsetsCompat.Type.statusBars() 和 WindowInsetsCompat.Type.navigationBars() 可以控制状态栏和导航栏的显示和隐藏。

windowInsetsController.hide(WindowInsetsCompat.Type.statusBars())
windowInsetsController.hide(WindowInsetsCompat.Type.navigationBars())
  • 1.
  • 2.
显示状态栏和导航栏

同样，我们可以通过以下代码来显示状态栏和导航栏。

windowInsetsController.show(WindowInsetsCompat.Type.statusBars())
windowInsetsController.show(WindowInsetsCompat.Type.navigationBars())
  • 1.
  • 2.
设置系统窗口行为

你可以使用 WindowInsetsControllerCompat 来设置系统窗口的显示行为。例如，可以设置系统栏在滑动手势下显示。

windowInsetsController.systemBarsBehavior = 
    WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
  • 1.
  • 2.
WindowInsetsControllerCompat 的 Behavior 标志位

WindowInsetsControllerCompat 的 systemBarsBehavior 属性决定了系统栏（状态栏和导航栏）在隐藏和显示时的行为。主要有三个常量可用：

1、 BEHAVIOR_SHOW_BARS_BY_SWIPE（滑动显示系统栏）：

  • 当系统栏隐藏时，用户可以通过从系统栏区域向内滑动来显示。
  • 它是API 21（Lollipop）及以上的默认行为。
windowInsetsController.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_BARS_BY_SWIPE
  • 1.

2、 BEHAVIOR_SHOW_BARS_BY_TOUCH（触摸显示系统栏）：

  • 当系统栏隐藏时，用户可以通过触摸屏幕的任意位置来显示系统栏。这个行为可能导致误触。
windowInsetsController.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_BARS_BY_TOUCH
  • 1.

3、 BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE（滑动显示临时系统栏）：

  • 当系统栏隐藏时，用户可以通过从系统栏区域向内滑动来临时显示系统栏。几秒钟后系统栏会自动隐藏。
windowInsetsController.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
  • 1.
设置状态栏和导航栏的颜色样式

你可以设置状态栏和导航栏的颜色样式（亮色或暗色），以便在不同主题下提供更好的用户体验。

windowInsetsController.isAppearanceLightStatusBars = true // 状态栏使用亮色样式
windowInsetsController.isAppearanceLightNavigationBars = true // 导航栏使用亮色样式
  • 1.
  • 2.
示例：简单的 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
    }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.

总结

WindowInsetsControllerCompat 为开发者提供了一种建议使用的方式来处理和控制 Android 系统的窗口插入。与传统方法相比，它更现代、更灵活，同时也更兼容不同的 Android 版本。因此，在处理状态栏、导航栏的显示和样式时，建议使用 WindowInsetsControllerCompat。

欢迎关注我的公众号AntDream查看更多精彩文章！