写在前面
这是一篇译文,原文自Android developer的Hiding the Status Bar,文中图片大都来自此网站,外链也将会链到android dev。
但并不是完全翻译,为方便表述有修改,带私货
转载请表明原文出处:http://www.jianshu.com/p/e14ceff34f85
效果
注:如果你将状态栏收起了,那么在一般情况下也应该把action bar给收起来。
在Android 4.0 及以前的版本收起状态栏
在Android 4.0(API level 14)及以前,你可以使用 设置WindowManager flag来收起状态栏。有两种方法可以实现这个目的:设置manifest文件中activity的theme或者是代码动态设置。
1、设置manifest文件中设置activity的theme
当然了,如果你希望你的app持续着状态栏收起的状态的话,那么设置activity的theme是最好的,下面是一个小栗子:
<application
...
android:theme="@android:style/Theme.Holo.NoActionBar.Fullscreen" >
...
</application>
用这种方法的好处是显而易见的:
- 它更容易维护,且更难出错,因为它只修改了一处代码;
- 它能使UI过渡更平滑,因为在实例化你的activity以前系统就有了那些用于渲染UI的信息了;
2、代码动态修改WindowManager flag
直接上代码:
public class MainActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// If the Android version is lower than Jellybean, use this call to hide
// the status bar.
if (Build.VERSION.SDK_INT < 16) {
getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
WindowManager.LayoutParams.FLAG_FULLSCREEN);
}
setContentView(R.layout.activity_main);
}
...
}
一旦你设置了WindowManager flags以后,flags的作用就会持续到你清除这些flags为止。
当你已经enable了 FLAG_FULLSCREEN以后, 你还可以通过设置 FLAG_LAYOUT_IN_SCREEN 来让你的activity 的layout使用那些可用的相同区域。这样当状态栏展示或隐藏的时候,activity中的UI大小也不会发生变化。
在Android 4.1 及更高的版本收起状态栏
在Android 4.1 (API level 16)你可以使用setSystemUiVisibility()方法来收起状态栏,setSystemUiVisibility()方法会在view的层别上来设置UI flags;这些设置会聚合到window层别。对比设置WindowManage flag 来说,使用setSystemUiVisibility()方法来设置UI flags的话,可以使你拥有对System bar有更细颗粒的控制(我们在想在哪个Activity、什么时候收起状态栏都行)。同样举个小栗子:
View decorView = getWindow().getDecorView();
// 隐藏状态栏的核心代码
int uiOptions = View.SYSTEM_UI_FLAG_FULLSCREEN;
decorView.setSystemUiVisibility(uiOptions);
// 如果隐藏了状态栏的话,记得也隐藏actionBar
ActionBar actionBar = getActionBar();
if(actionBar != null){ //此判断为译者增加
actionBar.hide();
}
(附:你使用getActionBar获取ActionBar的话,有可能获取到一个null的ActionBar,因而为了安全,应该在hide操作之前验一下空)
注意事项:
- 一旦UI flags被clear掉了,你就应该重新设置这些flag。关于如何监听UI的可视化状态的改变,可参见Responding to UI Visibility Changes
- 你在不同的方法设置UI flags有可能导致不同的结果。如果你在activity的onCreate方法中设置UI flags的话,那么当你按下home键返回到桌面以后,那么状态栏就会重新出现,而当用户重新打开这个activity的时候,状态栏依旧显示。所以啊,如果你想用户回到这个activity的时候还是原来的隐藏状态栏的话,那么就应该在onResume()或者是onWindowFocusChanged()
- 在有你给出的view是可见的情况下,那该view调用setSystemUiVisibility()才是有效的(就是说调用这个方法的view必须是visible)
- 一旦一个view不在屏幕上了,那么在这个view上通过 setSystemUiVisibility()方法设置的flags都会被清除。(原文是Navigating away from the view causes flags set with setSystemUiVisibility() to be cleared.自行体会navigate away的意思,总感觉这个我翻译得不是很到位)
总结
那么根据上面的介绍,我们可以就写出两个静态方法了:
public static void hideStatusBar(Activity activity){
if (Build.VERSION.SDK_INT < 16) {
activity.getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
WindowManager.LayoutParams.FLAG_FULLSCREEN);
}
else {
View decorView = activity.getWindow().getDecorView();
// Hide Status Bar.
int uiOptions = View.SYSTEM_UI_FLAG_FULLSCREEN;
decorView.setSystemUiVisibility(uiOptions);
}
}
public static void showStatusBar(Activity activity){
if (Build.VERSION.SDK_INT < 16) {
activity.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);
}
else {
View decorView = activity.getWindow().getDecorView();
// Show Status Bar.
int uiOptions = View.SYSTEM_UI_FLAG_VISIBLE;
decorView.setSystemUiVisibility(uiOptions);
}
}
代码很简单,也很容易用,我就不写文档了。但是我没有按着官方建议收起Action Bar,各位可以根据自己的需求来决定是否收起Action Bar:
// 如果隐藏了状态栏的话,记得也隐藏actionBar
ActionBar actionBar = getActionBar();
if(actionBar != null){ //此判断为译者增加
actionBar.hide();
}
此外,也可以通过设置一个view的WindowManager flags来收起(/展示)状态栏:
view.setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN); //收起状态栏
view.setSystemUiVisibility(View.SYSTEM_UI_FLAG_VISIBLE); //展示状态栏
在状态栏的后面也设置内容
在Android 4.1 以后,你可以设置你app的内容展示到状态栏的后面,这样做的话,在状态栏被隐藏或展示以后,你的UI的大小也不会发生任何变化。为了达到这个目的,你可以使用 SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN标签,同时你可能也需要 SYSTEM_UI_FLAG_LAYOUT_STABLE标签来使得你的app维持一个稳定的layout状态.
如果你需要使用上面的这个方案,那么你就应当确保app的主要部分不会被System bar给遮挡住。有两种方法
- 在大多数的情况下,你可以在你的XML layout文件中,将android:fitsSystemWindows属性设置为true。这样做可以调整父ViewGroup的padding,使之留出空位来放置system windows。这个做法在大部分情况下就已经足够了。
- 然而在小部分的情况下,你仍需要手动修改默认的padding来适应,这时候需要重写 fitSystemWindows(Rect insets)方法(然而这个方法在API 20就被弃用了),我们就可以相对于System bar控制我们的UI布局了。(关于这个方法详细情况,可参见官方文档,解释得非常清楚)