Android通过WindowInsetsController设置系统栏颜色、Behavior、显示隐藏等

文章目录

WindowInsetsController（不推荐）

两种方式可以引入WindowInsetsController，一种直接通过API的val controller = window.decorView.windowInsetsController获取，注意该方法在API30及以上才有，常用方法如下：

设置系统栏颜色

void setSystemBarsAppearance(@Appearance int appearance, @Appearance int mask);

@IntDef(flag = true, value = {APPEARANCE_OPAQUE_STATUS_BARS, APPEARANCE_OPAQUE_NAVIGATION_BARS,APPEARANCE_LOW_PROFILE_BARS, APPEARANCE_LIGHT_STATUS_BARS,APPEARANCE_LIGHT_NAVIGATION_BARS, APPEARANCE_SEMI_TRANSPARENT_STATUS_BARS,APPEARANCE_SEMI_TRANSPARENT_NAVIGATION_BARS})
@interface Appearance {}

如：

setSystemBarsAppearance(APPEARANCE_LIGHT_STATUS_BARS, APPEARANCE_LIGHT_STATUS_BARS) //状态栏设置为黑色
setSystemBarsAppearance(0, APPEARANCE_LIGHT_STATUS_BARS) //状态栏设置成白色

设置系统栏Behavior

void setSystemBarsBehavior(@Behavior int behavior);

int BEHAVIOR_DEFAULT = 1; //默认设置，通过滑动系统栏展示出来后不再隐藏
int BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE = 2; //系统栏展示一会后再次消失
@Retention(RetentionPolicy.SOURCE)
@IntDef(value = {BEHAVIOR_DEFAULT, BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE})
@interface Behavior { }

展示与隐藏

void hide(@InsetsType int types); //隐藏系统栏(包括状态栏、导航栏、或者两者都包含)
void show(@InsetsType int types); //展示系统栏(包括状态栏、导航栏、或者两者都包含)

@InsetsType常用设置：
- WindowInsets.Type.statusBars() //状态栏
- WindowInsets.Type.navigationBars() //导航栏
- WindowInsets.Type.systemBars() //系统栏（包括状态栏、导航栏）
- WindowInsets.Type.ime() //键盘 (需要界面有输入控件且获取到焦点才能起作用)
- WindowInsets.Type.captionBar() //标题栏

注意：通过setSystemBarsBehavior()设置的有两个值，一个是BEHAVIOR_DEFAULT：默认设置，当系统栏通过hide()隐藏后，从隐藏栏的屏幕边缘滑动，系统栏会再次显示且不再消失；另一个是BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE：系统栏通过hide()隐藏后，从隐藏栏的屏幕边缘滑动，系统栏会再次显示且会在一段时间后再次自动隐藏。

ViewCompat.getWindowInsetsController(推荐)

除了上述通过系统API方法获取，还可以通过AndroidX的方式引入: implementation 'androidx.core:core-ktx:1.5.0'，获取WindowInsetsController：

val controller = ViewCompat.getWindowInsetsController(window.decorView)

设置系统栏颜色

//设置状态栏颜色(6.0及以上生效)， true为黑色，反之为白色
public void setAppearanceLightStatusBars(boolean isLight) 

//设置导航栏颜色(8.0及以上生效) 
public void setAppearanceLightNavigationBars(boolean isLight)

设置系统栏Behavior

//状态栏行为
public void setSystemBarsBehavior(@Behavior int behavior)

@Behavior中的值如下：

@Retention(RetentionPolicy.SOURCE)
@IntDef(value = {BEHAVIOR_SHOW_BARS_BY_TOUCH, BEHAVIOR_SHOW_BARS_BY_SWIPE,
            BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE})
@interface Behavior {}

@Behavior中重点关注下：WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE，系统栏通过hide()隐藏后，从隐藏栏的屏幕边缘滑动，系统栏会再次显示且会在一段时间后再次自动隐藏。

展示与隐藏

//系统栏展示
public void show(@InsetsType int types)
//系统栏隐藏
public void hide(@InsetsType int types)

@InsetsType常用设置：
- WindowInsetsCompat.Type.statusBars() //状态栏
- WindowInsetsCompat.Type.navigationBars() //导航栏
- WindowInsetsCompat.Type.systemBars() //系统栏（包括状态栏、导航栏）
- WindowInsetsCompat.Type.ime() //键盘 (需要界面有输入控件且获取到焦点才能起作用)
- WindowInsetsCompat.Type.captionBar() //标题栏