目录
此篇文章介绍的内容都是考虑到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、直接隐藏状态栏,且状态栏可下拉出来,下来出来的状态栏是半透明的,但是一会后状态栏还是会自动缩回去。下面三种实现方式同效果。(这种方式在刘海屏中会导致有刘海的状态栏直接置黑,且显示内容是不会上移到状态栏处)
<!--第一种--><itemname="android:windowFullscreen">true</item>
//第二种
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可以上移到状态栏。具体如下
funhideStatusBar(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方式实现:
/**
* 隐藏状态栏,显示内容上移到状态栏
*/funhideStatusBar3(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都被遮挡了。也就是页面内容延伸到了导航栏底部。
沉浸式状态栏
沉浸式状态栏就很容易理解了,就是把显示的内容上移到状态栏,但是又不隐藏状态栏。(当然直接修改状态栏的颜色,让它和背景一样也是可以的,但是这种仅仅在纯色的情况下实用,如果是图片类的背景就不适用了)。实现如下:
/**
* 沉浸式状态栏
*/funtransparentStatusBar(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。看下效果:
隐藏导航栏
没啥好说的,直接上代码吧
/**
* 隐藏导航栏
*/funhideNavigation(window: Window){//将显示内容下移到导航栏
window.decorView.systemUiVisibility = View.SYSTEM_UI_FLAG_HIDE_NAVIGATION or View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
}
用 WindowInsetsController方式实现:
/**
* 隐藏导航栏
*/funhideNavigation2(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
}}
沉浸式导航栏
/**
* 沉浸式导航栏,这里就不用WindowInsetsControllerCompat 实现了,因为View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION 没办法等效替换
* fixme :有BUG, View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION 不仅仅将内容下移到导航栏,还会上移到状态栏
*/funtransparentNavigationBar(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 是赋值使用的,后一个会覆盖前一个的。实现如下:
/**
* 隐藏两个系统栏
*/funhideSystemBar(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方式实现:
/**
* 隐藏两个系统栏
*/funhideSystemBar2(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
}}}
沉浸式状态栏以及导航栏
/**
* 沉浸式状态栏以及导航栏
*/funtransparentSystemBar(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
}
/**
* 沉浸式状态栏以及导航栏
*/funtransparentSystemBar2(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 属性,那么在刘海屏手机上也会有一个上边距,如下图,在直屏手机中是正常的。 -
版权归原作者 _bigin 所有, 如有侵权,请联系我们删除。