关于android:系统栏与沉浸式

常见零碎栏需要

对于零碎栏(这里指状态栏和导航栏)，常见有如下需要

1. 设置零碎栏色彩
2. 实现全透明 / 半透明的零碎栏 – 使零碎栏笼罩在利用内容上

3. 确保零碎栏上图标文字的可读性

   • 浅色模式(light)，白底黑字
   • 深色模式(dark)，黑底白字

4. 沉迷式 – 暗藏零碎栏，但可通过交互从新显示，有三种交互模式：

   • 触摸屏幕显示
   • 滑过屏幕边缘显示
   • 滑过屏幕边缘显示并在数秒后从新暗藏

设置零碎栏色彩

• API21+ 可用
• WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS 必须被设置，默认是已设置的
  此标记指定由该利用窗口负责绘制零碎栏区域的背景，同时零碎栏窗口会将背景设置为全透明
  未设置此标记时零碎栏会将窗口背景设置为彩色

// 设置状态栏色彩 
window.statusBarColor = color

// 设置导航栏色彩 
window.navigationBarColor = color

// API28+ 能够设置导航栏分隔线色彩
window.navigationBarDividerColor = color

实现全透明 / 半透明的零碎栏

使零碎栏笼罩在利用内容上，再设置零碎栏色彩就能够实现 全透明 / 半透明 的零碎栏

• API16+ 可用

window.decorView.apply {
    // 设置状态栏零碎栏笼罩在利用内容上
    systemUiVisibility = systemUiVisibility or View.SYSTEM_UI_FLAG_LAYOUT_STABLE or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN 
    
    // 设置导航栏零碎栏笼罩在利用内容上 
    systemUiVisibility = systemUiVisibility or View.SYSTEM_UI_FLAG_LAYOUT_STABLE or View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION 
} 

注：设置SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN 只会对状态栏失效，但设置了 SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION 却同时对状态栏和导航栏失效，但文档上却没说，不晓得是否兼容性问题

• API30+ 提供了新的 API，View.SYSTEM_UI_FLAG_LAYOUT_*标记为废除了

// 当设置为 true 时，框架还是会旧用的 API 来解决
// 当设置为 false 时，状态栏与导航栏会笼罩在利用内容上，无奈别离设置
void setDecorFitsSystemWindows(boolean decorFitsSystemWindows)

API19+ 应用以下标记也能够实现全透明零碎栏，但 API30+ 曾经标记废除，倡议不要应用

• WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS
  设置后零碎主动增加 View.SYSTEM_UI_FLAG_LAYOUT_STABLE or View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
• WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION
  设置后零碎主动增加 View.SYSTEM_UI_FLAG_LAYOUT_STABLE or View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION

确保零碎栏上图标文字的可读性

在设置了通明零碎栏时，零碎栏笼罩在利用内容上
如果零碎栏上的图标文字与利用内容对比度不够，那就看不清零碎栏图标文字了

在 API23+ 可设置状态栏浅色模式
在 API26+ 可设置导航栏浅色模式

window.decorView.systemUiVisibility = window.decorView.systemUiVisibility or View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR
window.decorView.systemUiVisibility = window.decorView.systemUiVisibility or View.SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR

在 API29+，当零碎栏色彩为 0(通明)时，可设置是否由零碎栏窗口绘制一个半透明的背景来提供对比度

• 当零碎栏在浅色模式时，绘制红色的半透明背景，彩色的图标文字
• 当零碎栏在深色模式时，绘制彩色的半透明背景，红色的图标文字

// 状态栏默认 false
window.isStatusBarContrastEnforced = false
// 导航栏默认 true
window.isNavigationBarContrastEnforced = true

零碎栏惯例操作

总结一下，能够发现零碎栏有如下基本操作，可组合应用

• 设置零碎栏背景色
• 设置笼罩在利用内容上
• 设置零碎栏浅色模式
• 设置是否在零碎纺栏色彩为 0 时，显示默认的零碎栏半透明背景

定义如下接口，能够不便地批改零碎栏状态

interface Bar { 
    // 设置零碎栏背景色
    fun color(@ColorInt color: Int): Bar

    // 设置笼罩在利用内容上
    fun overlay(value: Boolean = true): Bar
    
    // 设置零碎栏浅色模式
    fun light(value: Boolean = true): Bar

    // 设置是否在零碎纺栏色彩为 0 时，显示默认的零碎栏半透明背景
    fun contrast(value: Boolean = true): Bar
}

提供扩大函数

fun Activity.systemBars(): Bar = SystemBars(window)
fun Fragment.systemBars(): Bar = SystemBars(requireActivity().window)
fun Dialog.systemBars(): Bar = SystemBars(window!!)

fun Activity.statusBar(): Bar = StatusBar(window)
fun Fragment.statusBar(): Bar = StatusBar(requireActivity().window)
fun Dialog.statusBar(): Bar = StatusBar(window!!)

fun Activity.navigationBar(): Bar = NavigationBar(window)
fun Fragment.navigationBar(): Bar = NavigationBar(requireActivity().window)
fun Dialog.navigationBar(): Bar = NavigationBar(window!!)

var Window.isDrawsSystemBarBackgrounds: Boolean

var Window.isStatusBarOverlay: Boolean
var Window.isStatusBarLight: Boolean

var Window.isNavigationBarOverlay: Boolean 
var Window.isNavigationBarLight: Boolean

应用

// 设置全透明零碎栏
statusBar().overlay().color(Color.TRANSPARENT)

// 设置半透明零碎栏
statusBar().overlay().color(0x66ff0000) 

在沉迷式模式下，操作 color/light/contrast 有效

沉迷式

安卓零碎提供了三种沉迷式模式，它们都会暗藏零碎栏

• 向后歪斜模式 – 触摸屏幕从新显示零碎栏
• 沉迷模式 – 滑过屏幕边缘从新显示零碎栏
• 粘性沉迷模式 – 滑过屏幕边缘从新显示零碎栏并在数秒后从新暗藏，此形式无奈收到零碎栏的可见性变动事件

fun Window.immersive(enable: Boolean = true, swipe: Boolean = false, transientBars: Boolean = false) {
    // 在暗藏 / 显示零碎栏时，不心愿布局随之扭转
    WindowCompat.setDecorFitsSystemWindows(this, !enable)

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {if (enable) {
            // 从新显示的形式
            insetsController?.systemBarsBehavior = when {
                swipe && transientBars -> WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
                swipe -> WindowInsetsController.BEHAVIOR_SHOW_BARS_BY_SWIPE
                else -> WindowInsetsController.BEHAVIOR_SHOW_BARS_BY_TOUCH
            }
            // 暗藏零碎栏
            insetsController?.hide(WindowInsets.Type.systemBars())
        } else {
            // 退出沉迷式
            insetsController?.show(WindowInsets.Type.systemBars())
        }
    } else {
        // 暗藏零碎栏
        val flags = View.SYSTEM_UI_FLAG_FULLSCREEN or View.SYSTEM_UI_FLAG_HIDE_NAVIGATION

        val immersiveFlags = when {
            // 退出沉迷式
            !enable -> View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY or View.SYSTEM_UI_FLAG_IMMERSIVE
            // 从新显示的形式
            swipe && transientBars -> View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
            swipe -> View.SYSTEM_UI_FLAG_IMMERSIVE
            else -> 0
        }
        setSystemUiVisibility(flags or immersiveFlags, enable)
    }
}

工具库

https://github.com/czy1121/sy…

DEMO APK 下载：https://github.com/czy1121/sy…

repositories {maven { url "https://gitee.com/ezy/repo/raw/android_public/"}
} 
dependencies {implementation "me.reezy.jetpack:systembars:0.4.0"}