目录
- window.decorView.systemUiVisibility 的参数常量
- 1.View.SYSTEM_UI_FLAG_HIDE_NAVIGATION:(>=api16)
- 2.View.SYSTEM_UI_FLAG_FULLSCREEN:(>=api16)
- 3.View.SYSTEM_UI_FLAG_IMMERSIVE:(>=api19)
- 4.View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY:(>=api19)
- 5.View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION:(>=api16)
- 6.View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN:(>=api16)
- 7.View.SYSTEM_UI_FLAG_LAYOUT_STABLE:
- window.addFlags()的常量参数
- WindowInsetsControllerCompat 类
- 实现需求和方式
- 总结
此篇文章介绍的内容都是考虑到5.0 版本以上。5.0以下的不做介绍。演示的代码皆为kotlin实现
首先一般设置是包括两方面的,第一是设置 window.decorView.systemUiVisibility ,第二是设置 window.addFlags() 这些方法都有一些常量的设置。但是在API 30 版本之后又新出了一个 WindowInsetsControllerCompat 的类,用来提供一个统一的一些操作。
参考: 传送门
能够造成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的显示或隐藏而不稳定。
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)
上面的参数常量,大部分都会提示已经过期了,因为在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、直接隐藏状态栏,且状态栏可下拉出来,下来出来的状态栏是半透明的,但是一会后状态栏还是会自动缩回去。下面三种实现方式同效果。(这种方式在刘海屏中会导致有刘海的状态栏直接置黑,且显示内容是不会上移到状态栏处)
- true
//第二种window.addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN)
//第三种window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY or View.SYSTEM_UI_FLAG_FULLSCREEN
WindowInsetsControllerCompat(window, window.decorView).let { it.hide(WindowInsetsCompat.Type.navigationBars()) it.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE}
用 WindowInsetsController方式实现:
WindowInsetsControllerCompat(window, window.decorView).let { it.hide(WindowInsetsCompat.Type.navigationBars()) it.systemBarsBehavior = WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE }
- 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;
使用方式如下:
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 可以上升到刘海屏的状态栏,还需要加上 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 }
用 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// } } }
此处 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 }
看下效果图:
效果是实现了,但是有点小瑕疵,我们是不希望状态栏遮住我们的内容,但是如果每个页面都要手动计算状态栏的高度然后去设置padding 就过于麻烦了。很简单,在布局文件的根布局加上:
android:fitsSystemWindows="true"
这个属性只有设置了 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 }
用 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 } }
沉浸式导航栏
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 }
记得要配合 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 } }
用 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 } } }
沉浸式状态栏以及导航栏
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 }
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 } }
记得要配合 fitsSystemWindows 使用
- 1、隐藏状态栏时,刘海屏需要多做两个步骤
①:将 window 上移到状态栏位置。
②:将decorView 上移到状态栏位置。
而隐藏导航栏时则直接隐藏即可。 - 2、沉浸式设置都要配合 fitsSystemWindows 使用才不会遮挡显示内容
- 3、隐藏状态栏的时候,如果加上了 fitsSystemWindows 属性,那么在刘海屏手机上也会有一个上边距,如下图,在直屏手机中是正常的。
-
来源地址:https://blog.csdn.net/qq_32664007/article/details/126279919