• 【UI篇】Android 沉浸式状态栏的那些事

    目录


    此篇文章介绍的内容都是考虑到5.0 版本以上。5.0以下的不做介绍。演示的代码皆为kotlin实现
    首先一般设置是包括两方面的，第一是设置 window.decorView.systemUiVisibility ，第二是设置 window.addFlags() 这些方法都有一些常量的设置。但是在API 30 版本之后又新出了一个 WindowInsetsControllerCompat 的类，用来提供一个统一的一些操作。

    window.decorView.systemUiVisibility 的参数常量

    参考： 传送门
    能够造成SystemUI Flag被系统自动清除的交互分类

    • 1、触摸屏幕任何位置
    • 2、顶部下拉状态栏
    • 3、底部上拉导航栏
    • 4、Window的变化(如：跳转到其他界面、弹出键盘等)

    1.View.SYSTEM_UI_FLAG_HIDE_NAVIGATION：(>=api16)

    作用是隐藏系统NavigationBar。
    但是用户的任何交互，都会导致此Flag被系统清除，进而导航栏自动重新显示，同时View.SYSTEM_UI_FLAG_FULLSCREEN也会被自动清除，因此StatusBar也会同时显示出来。

    2.View.SYSTEM_UI_FLAG_FULLSCREEN：(>=api16)

    作用是隐藏StatusBar。
    和WindowManager.LayoutParams.FLAG_FULLSCREEN有相同视觉效果。不同在于，此Flag一般用在暂时需要全屏的情形（如：阅读应用，全屏视频等），以便让用户的注意力暂时集中在内容上，而如果只是简单的需要一直停留在全屏状态（如：游戏应用），使用WindowManager.LayoutParams.FLAG_FULLSCREEN则是更好的选择。
    此Flag会因为各种的交互（如：跳转到其他应用,下拉StatusBar，弹出键盘）的发送而被系统清除。

    3.View.SYSTEM_UI_FLAG_IMMERSIVE：(>=api19)

    作用:避免某些用户交互造成系统自动清除全屏状态。

    • 1、View.SYSTEM_UI_FLAG_IMMERSIVE和View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY的使用主要是为了当设置全屏模式时，避免某些用户交互造成系统自动清除全屏状态。
    • 2、当使用View.SYSTEM_UI_FLAG_HIDE_NAVIGATION隐藏导航栏时，配合此特性，只有第三、四种操作会导致导航栏的隐藏状态被系统自动清除；否则，任何交互都会导致导航栏的隐藏状态被系统自动清除。
    • 3、此标识只有配合View.SYSTEM_UI_FLAG_HIDE_NAVIGATION才有作用。

    4.View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY：(>=api19)

    作用:避免某些用户交互造成系统自动清除全屏状态。同时Activity的部分内容也因此被StatusBar覆盖遮挡。

    • 1、用View.SYSTEM_UI_FLAG_HIDE_NAVIGATION隐藏导航栏，配合使用此Flag,只有用户的第四种操作会导致状态栏或（和）导航栏的隐藏状态被系统自动清除。否则任何交互都会导致相应状态的清除。
    • 2、此Flag只有配合SYSTEM_UI_FLAG_FULLSCREEN和SYSTEM_UI_FLAG_HIDE_NAVIGATION使用时才会起作用。

    5.View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION：(>=api16)

    作用:在不隐藏导航栏的情况下，将Activity的显示范围扩展到导航栏底部。同时Activity的部分内容也因此被NavigationBar覆盖遮挡。

    • 1、当使用此Flag时，设置fitSystemWindow=true的view，会被系统自动添加大小为NavigationBar高度相同的paddingBottom。
    • 2、当window设置WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION时，此Flag会被系统会自动添加。

    6.View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN：(>=api16)

    作用：在不隐藏StatusBar的情况下，将view所在window的显示范围扩展到StatusBar下面。同时Activity的部分内容也因此被StatusBar覆盖遮挡。

    • 1、当使用此Flag时，设置fitSystemWindow=true的view，会被系统自动添加大小为statusBar和ActionBar高度之和相同的paddingTop。
    • 2、当window设置WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS时，此Flag会被系统会自动添加。

    7.View.SYSTEM_UI_FLAG_LAYOUT_STABLE:

    作用: 稳定布局。当StatusBar和NavigationBar动态显示和隐藏时，系统为fitSystemWindow=true的view设置的padding大小都不会变化，所以view的内容的位置也不会发生移动。

    • 1、当使用SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN或SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION)，同时view设置fitSystemWindow=true时，系统会为此View自动设置padding。此padding的大小由View.fitSystemWindows(Rect)的Rect提供。一般情况下，当StatusBar和NavigationBar显示时，paddingTop的大小为StatusBar的高度。如果设置了getWindow().requestFeature(Window.FEATURE_ACTION_BAR_OVERLAY),paddingTop的大小则为StatusBar和ActionBar的高度之和。paddingBottom的大小则为NavigationBar的高度。当StatusBar和NavigationBar被隐藏时，View的padingBottom和paddingTop的大小就变成了0, 因此StatusBar和NavigationBar的显示和隐藏造成的padding变化，进而View内容的位置变化，从而造成位置闪动的视觉效果，影响体验。
      使用SYSTEM_UI_FLAG_LAYOUT_STABLE的作用便是当StatusBar和NavigationBar的显示和隐藏，系统为View设置的padding都不会变化，因此View内容的位置不会变化，此即为稳定布局。
      -. （SYSTEM_UI_FLAG_FULLSCREEN |SYSTEM_UI_FLAG_LAYOUT_STABLE）时，
      会同时隐藏Actionbar和StatusBar，但StatusBar所占空间不会隐藏，只会变成空白。同时View所在window的显示范围也不会伸展到StatusBar所占空间。若是加上SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN，View所在window的显示范围则会伸展到StatusBar所在的空间。
      同样对NavigationBar如此操作，也会是一样的效果。
    • 2、当你设置了SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN时，配合此特性，若此时设置或取消SYSTEM_UI_FLAG_FULLSCREEN，不会因为StatusBar的显示或隐藏不会造成内容view的不稳定。
    • 3、当你设置了SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN和SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION，配合此特性，若此时设置或取消SYSTEM_UI_FLAG_FULLSCREEN和SYSTEM_UI_FLAG_HIDE_NAVIGATION，不会因为StatusBar和导航栏的显示或隐藏不会造成内容view的不稳定。
    • 4、此特性不应该只配合SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION使用
    • 5、使用WindowManager.LayoutParams.FLAG_FULLSCREEN（而不是使用SYSTEM_UI_FLAG_FULLSCREEN）来隐藏StatusBar是一个一直持续隐藏的状态。这时你仍然可以使用SYSTEM_UI_FLAG_FULLSCREEN | SYSTEM_UI_FLAG_LAYOUT_STABLE隐藏Actionbar，并且不会因为ActionBar的显示或隐藏而不稳定。

    window.addFlags()的常量参数

    1.WindowMananger.FLAG_TRANSLUCENT_STATUS： (>=api16)

    • 1、半透明StatusBar,并且不会因用户交互而被清除。
    • 2、设置了此flag,系统会自动设置View.SYSTEM_UI_FLAG_LAYOUT_STABLE和View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN

    2.WindowMananger.FLAG_FULLSCREEN：

    • 1、用于隐藏StatusBar。隐藏效果不会被清除。
    • 2、使用此flag,系统会自动忽略输入法的SOFT_INPUT_ADJUST_RESIZE的特性。

    3.WindowMananger.FLAG_TRANSLUCENT_NAVIGATION：

    • 1.半透明NavigationBar,并且不会因用户交互而被清除。
    • 2.设置了此flag,系统会自动设置View.SYSTEM_UI_FLAG_LAYOUT_STABLE和View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
      最低版本支持：Android4.4 (api 19)

    4.WindowMananger.FLAG_DRAWS_SYSTEM_BAR_BACKGROUND：

    • 1.用于未StatusBar和NavigationBar设置背景颜色。
    • 2.原理：将StatusBar和NavigationBar设置为透明背景，并且将StatusBar和NavigationBar所在空间设置为Window.getStatusBarColor() 和Window.getNavigationBarColor()方法获得的颜色。
      最低版本支持：Android5.0 (api 21)

    WindowInsetsControllerCompat 类

    上面的参数常量，大部分都会提示已经过期了，因为在API 30 版本里面出了WindowInsetsControllerCompat 的一个新类。
    比如 View.SYSTEM_UI_FLAG_FULLSCREEN 以及 WindowManager.LayoutParams.FLAG_FULLSCREEN 常量点进去都会提示使用：

    • @deprecated Use {@link WindowInsetsController#hide(int)} with {@link Type#statusBars()}

    但是以上两个常量的作用并不一样。 View.SYSTEM_UI_FLAG_FULLSCREEN 的隐藏作用在下拉状态栏之后就会取消隐藏。需要搭配 View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY 来位置隐藏的效果。 而查看 View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY 源码又会提示使用：

    • @deprecated Use {@link WindowInsetsController#BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE} instead.

    经过验证也得出 WindowInsetsController#hide(int) 方法的隐藏会被下拉状态栏操作取消。需要设置 controller.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE 来维持隐藏的状态。

    实现需求和方式

    隐藏状态栏（全屏显示）

    隐藏状态栏分两种情况，一个是在非刘海屏或挖孔屏，也就是正常的直面屏上。

    • 1、直接隐藏状态栏，且状态栏可下拉出来，下来出来的状态栏是半透明的，但是一会后状态栏还是会自动缩回去。下面三种实现方式同效果。（这种方式在刘海屏中会导致有刘海的状态栏直接置黑，且显示内容是不会上移到状态栏处）
    
<item name="android:windowFullscreen">trueitem>

    • 1
    • 2
    //第二种
window.addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN)

    • 1
    • 2
    //第三种
window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY or View.SYSTEM_UI_FLAG_FULLSCREEN

    • 1
    • 2
    WindowInsetsControllerCompat(window, window.decorView).let {
     it.hide(WindowInsetsCompat.Type.navigationBars())
     it.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
}

    • 1
    • 2
    • 3
    • 4

    用 WindowInsetsController方式实现：

    		WindowInsetsControllerCompat(window, window.decorView).let {
            it.hide(WindowInsetsCompat.Type.navigationBars())
            it.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
        }

    • 1
    • 2
    • 3
    • 4

    在这里插入图片描述

    • 2、适配刘海屏的隐藏状态栏。先看一下用上面的方法在挖孔屏上面的实现效果：

    在这里插入图片描述
    可以看到上面有一条很粗的黑边。因为那是前摄挖孔所在，默认显示内容是不能占用挖孔的地方的。
    而google 官方是有针对刘海屏的适配方案的，简单的说就是可以让显示内容上移到刘海状态栏的位置。有三种方式供选择：

     //默认情况,全屏页面不可用刘海区域,非全屏页面可以进行使用
 public static final int LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT = 0;

 //不允许使用刘海区域
 public static final int LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER = 2;

 //允许页面延伸到刘海区域
 public static final int LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES = 1;

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8

    使用方式如下：

    		if (Build.VERSION.SDK_INT >= 28) {
            val lp = window.attributes
            lp.layoutInDisplayCutoutMode =
                WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
            window.attributes = lp
        }

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6

    但是加上这个只是允许window 可以上升到刘海屏的状态栏，还需要加上 View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN 来确保view可以上移到状态栏。具体如下

        fun hideStatusBar(window: Window) {
        //直屏手机一行就搞定
        window.addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN)

        //允许window 的内容可以上移到刘海屏状态栏
        if (Build.VERSION.SDK_INT >= 28) {
            val lp = window.attributes
            lp.layoutInDisplayCutoutMode =
                WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
            window.attributes = lp
        }
        //将显示内容上移到状态栏
        window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
    }

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14

    用 WindowInsetsController方式实现：

        /**
     * 隐藏状态栏，显示内容上移到状态栏
     */
    fun hideStatusBar3(window: Window) {
        WindowInsetsControllerCompat(window, window.decorView).let {
            //效果同SYSTEM_UI_FLAG_FULLSCREEN
            it.hide(WindowInsetsCompat.Type.statusBars())
            //维持隐藏的效果，hide 方法的隐藏会被下拉状态栏取消的。效果同 View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
            it.systemBarsBehavior =
                WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
        }

        //允许window 的内容可以上移到刘海屏状态栏
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
            val lp = window.attributes
            lp.layoutInDisplayCutoutMode =
                WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
            window.attributes = lp

//            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
                //将显示内容上移
//                window.setDecorFitsSystemWindows(false)
//            } else {
                window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
//            }
        }
    }

    • 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

    此处 View.View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN 之所以不用 window.setDecorFitsSystemWindows(false) 代替，是因为 window.setDecorFitsSystemWindows(false) 还包含有 View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION的作用。如果替代了，则效果如下：
    在这里插入图片描述
    可以看到底部的两行textview都被遮挡了。也就是页面内容延伸到了导航栏底部。

    沉浸式状态栏

    沉浸式状态栏就很容易理解了，就是把显示的内容上移到状态栏，但是又不隐藏状态栏。（当然直接修改状态栏的颜色，让它和背景一样也是可以的，但是这种仅仅在纯色的情况下实用，如果是图片类的背景就不适用了）。实现如下：

    	/**
     * 沉浸式状态栏
     */
    fun transparentStatusBar(window: Window){
        //去掉半透明的可能性
        window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS)
        //可以设置系统栏的背景色
        window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
        window.statusBarColor = Color.TRANSPARENT
        //view的位置上移到系统栏
        window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN or View.SYSTEM_UI_FLAG_LAYOUT_STABLE
    }

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12

    看下效果图：
    在这里插入图片描述
    效果是实现了，但是有点小瑕疵，我们是不希望状态栏遮住我们的内容，但是如果每个页面都要手动计算状态栏的高度然后去设置padding 就过于麻烦了。很简单，在布局文件的根布局加上：

    android:fitsSystemWindows="true"

    • 1

    这个属性只有设置了 View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION 或View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN，才会有效果。
    作用呢就是自动给view加上个对应系统栏高度的padding。看下效果：
    在这里插入图片描述

    隐藏导航栏

    没啥好说的，直接上代码吧

        /**
     * 隐藏导航栏
     */
    fun hideNavigation(window: Window) {
        //将显示内容下移到导航栏
        window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_HIDE_NAVIGATION or View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
    }

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7

    用 WindowInsetsController方式实现：

        /**
     * 隐藏导航栏
     */
    fun hideNavigation2(window: Window) {
        //将显示内容下移到导航栏
        WindowInsetsControllerCompat(window, window.decorView).let {
            //效果同SYSTEM_UI_FLAG_HIDE_NAVIGATION
            it.hide(WindowInsetsCompat.Type.navigationBars())
            //维持隐藏的效果，hide 方法的隐藏会被下拉状态栏取消的。效果同 View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
            it.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
        }
    }

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12

    沉浸式导航栏

    	/**
     * 沉浸式导航栏，这里就不用WindowInsetsControllerCompat 实现了，因为View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION 没办法等效替换
     * fixme :有BUG， View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION 不仅仅将内容下移到导航栏，还会上移到状态栏
     */
    fun transparentNavigationBar(window: Window) {
        //去掉半透明的可能性
        window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS)
        //可以设置系统栏的背景色
        window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
        window.navigationBarColor = Color.TRANSPARENT
        //view的位置下移到导航栏
        window.decorView.systemUiVisibility =
            View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION or View.SYSTEM_UI_FLAG_LAYOUT_STABLE
    }

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14

    记得要配合 fitsSystemWindows 使用

    在这里插入图片描述

    隐藏状态栏以及导航栏

    如果同时使用上面的两个方法组合是不行的。因为 window.decorView.systemUiVisibility 是赋值使用的，后一个会覆盖前一个的。实现如下：

        /**
     * 隐藏两个系统栏
     */
    fun hideSystemBar(window: Window){
        //直屏手机一行就搞定
        window.decorView.systemUiVisibility =
                    // 隐藏系统栏
                    View.SYSTEM_UI_FLAG_FULLSCREEN or
                    // 隐藏导航栏
                    View.SYSTEM_UI_FLAG_HIDE_NAVIGATION or
                    //维持隐藏的效果
                    View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY or
                    //将内容往上推到刘海屏的位置
                    View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN

        //允许window 的内容可以上移到刘海屏状态栏
        if (Build.VERSION.SDK_INT >= 28) {
            val lp = window.attributes
            lp.layoutInDisplayCutoutMode =
                WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
            window.attributes = lp
        }
    }

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23

    用 WindowInsetsController方式实现：

        /**
     * 隐藏两个系统栏
     */
    fun hideSystemBar2(window: Window) {
        WindowInsetsControllerCompat(window, window.decorView).let {
            //效果同SYSTEM_UI_FLAG_FULLSCREEN
            it.hide(WindowInsetsCompat.Type.statusBars())
            it.hide(WindowInsetsCompat.Type.navigationBars())
            //维持隐藏的效果，hide 方法的隐藏会被下拉状态栏取消的。效果同 View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
            it.systemBarsBehavior =
                WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
        }

        //允许window 的内容可以上移到刘海屏状态栏
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
            val lp = window.attributes
            lp.layoutInDisplayCutoutMode =
                WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES
            window.attributes = lp

            //在不隐藏系统栏的情况下，将内容移动到系统栏
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
                //该方法会同时作用于状态栏以及导航栏
                window.setDecorFitsSystemWindows(false)
            } else {
                window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
            }
        }
    }

    • 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
    • 28
    • 29

    在这里插入图片描述

    沉浸式状态栏以及导航栏

        /**
     * 沉浸式状态栏以及导航栏
     */
    fun transparentSystemBar(window: Window) {
        //去掉半透明的可能性
        window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS)
        //可以设置系统栏的背景色
        window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
        window.statusBarColor = Color.TRANSPARENT
        window.navigationBarColor = Color.TRANSPARENT
        //view的位置上移到系统栏
        window.decorView.systemUiVisibility =
                //将内容上移到状态栏
            View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN or
                    //将内容下移到状态栏
                    View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION or
                    View.SYSTEM_UI_FLAG_LAYOUT_STABLE
    }


    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
        /**
     * 沉浸式状态栏以及导航栏
     */
    fun transparentSystemBar2(window: Window) {
        //去掉半透明的可能性
        window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS)
        //可以设置系统栏的背景色
        window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS)
        window.statusBarColor = Color.TRANSPARENT
        window.navigationBarColor = Color.TRANSPARENT

        //在不隐藏系统栏的情况下，将内容移动到系统栏
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
            //该方法会同时作用于状态栏以及导航栏
            window.setDecorFitsSystemWindows(false)
        } else {
            window.decorView.systemUiVisibility =
                View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN or View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
        }
    }

    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20

    记得要配合 fitsSystemWindows 使用
    在这里插入图片描述

    总结

    • 1、隐藏状态栏时，刘海屏需要多做两个步骤
      ①：将 window 上移到状态栏位置。
      ②：将decorView 上移到状态栏位置。
      而隐藏导航栏时则直接隐藏即可。
    • 2、沉浸式设置都要配合 fitsSystemWindows 使用才不会遮挡显示内容
    • 3、隐藏状态栏的时候，如果加上了 fitsSystemWindows 属性，那么在刘海屏手机上也会有一个上边距，如下图，在直屏手机中是正常的。
      -在这里插入图片描述
  • 相关阅读:
    LinkedList详解
    字符串的常用方法
    不容错过！什么是领域驱动设计？为什么落地这么难？
    动静态链接库
    PCL 视图变换（OpenGL）
    elastic-job源码分析
    Unity笔记（5）：Make Character Animation【2D】
    java中springBoot+oss基础使用
    AIE有机荧光探针/荧光高分子纳米微球AIE-PEN FPNs/AIE有机荧光分子带电荷微球
    【AXI4 verilog】手把手带你撸AXI代码（四、AXI4接口的RAM设计）
  • 原文地址：https://blog.csdn.net/qq_32664007/article/details/126279919