System Bar是用来展示通知、表现设备状态和完成设备导航的屏幕区域。通常上来说,系统栏(System bar)包括状态栏和导航栏(Figure 1),他们一般都是与程序同时显示在屏幕上的。而照片、视频等这类沉浸式的应用可以临时弱化系统栏图标来创造一个更加专注的体验环境,甚至可以完全隐藏系统Bar。
Figure 1. System bars,包含[1]状态栏,和[2]导航栏。
一、淡化system bar
SYSTEM_UI_FLAG_LOW_PROFILE
这个标签。
// This example uses decor view, but you can use any visible view.这个例子用decor view,但是你可以用任何可见的view
View decorView = getWindow().getDecorView();
int uiOptions = View.SYSTEM_UI_FLAG_LOW_PROFILE; //淡化状态和通知栏,
// View.SYSTEM_UI_FLAG_LOW_PROFILE:状态栏显示处于低能显示状态(low profile模式),状态栏上一些图标显示会被隐藏。
显示:
View decorView = getWindow().getDecorView();
// Calling setSystemUiVisibility() with a value of 0 clears
// all flags.
//动态的清除显示标签
decorView.setSystemUiVisibility(0);
注意:
一旦用户触摸到了状态栏或者是系统栏,这个标签就会被清除,使系统栏重新显现(无透明度)。在标签被清除的情况下,如果你想重新淡化系统栏就必须重新设定这个标签。而按home也会清除这个标签。
下图为api17 的联想手机效果图:
二、隐藏system bar
在4.0及以下版本中隐藏状态栏
在Android 4.0及更低的版本中,你可以通过设置WindowManager
来隐藏状态栏。你可以动态的隐藏,也可以在你的manifest文件中设置Activity的主题。如果你的应用的状态栏在运行过程中会一直隐藏,那么推荐你使用改写manifest设定主题的方法(严格上来讲,即便设置了manifest你也可以动态的改变界面主题)。
<application
...
android:theme="@android:style/Theme.Holo.NoActionBar.Fullscreen" >
...
</application>
设置主题的优势是:
- 易于维护,且不像动态设置标签那样容易出错
- 有更流畅的UI转换,因为在初始化你的Activity之前,系统已经得到了需要渲染UI的信息
另一方面我们可以选择使用WindowManager
来动态隐藏状态栏。这个方法可以更简单的在用户与App进行交互式展示与隐藏状态栏。
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
标签之后(无论是通过Activity主题还是动态设置),这个标签都会一直生效直到你清除它。
设置了FLAG_LAYOUT_IN_SCREEN
之后,你可以拥有与启用FLAG_FULLSCREEN
后相同的屏幕区域。这个方法防止了状态栏隐藏和展示的时候内容区域的大小变化。
在4.1及以上版本中隐藏状态栏
在Android 4.1(API level 16)以及更高的版本中,你可以使用setSystemUiVisibility())来进行动态隐藏。setSystemUiVisibility()
在View层面设置了UI的标签,然后这些设置被整合到了Window层面。setSystemUiVisibility()
给了你一个比设置WindowManager
标签更加粒度化的操作。下面这段代码隐藏了状态栏:
View decorView = getWindow().getDecorView();
// Hide the status bar.
int uiOptions = View.SYSTEM_UI_FLAG_FULLSCREEN;
decorView.setSystemUiVisibility(uiOptions);
// Remember that you should never show the action bar if the
// status bar is hidden, so hide that too if necessary.
//注音:请永远不要在隐藏状态栏的时候显示Action Bar
ActionBar actionBar = getActionBar();actionBar.hide();
注意以下几点:
- 一旦UI标签被清除(比如跳转到另一个Activity),如果你还想隐藏状态栏你就必须再次设定它。详细可以看第五节如何监听并响应UI可见性的变化。
- 在不同的地方设置UI标签是有所区别的。如果你在Activity的onCreate()方法中隐藏系统栏,当用户按下home键系统栏就会重新显示。当用户再重新打开Activity的时候,onCreate()不会被调用,所以系统栏还会保持可见。如果你想让在不同Activity之间切换时,系统UI保持不变,你需要在onResume()与onWindowFocusChaned()里设定UI标签。
- setSystemUiVisibility()仅仅在被调用的View显示的时候才会生效。
- 当从View导航到别的地方时,用setSystemUiVisibility()设置的标签会被清除。
让内容显示在状态栏之后
在Android 4.1及以上版本,你可以将应用的内容显示在状态栏之后,这样当状态栏显示与隐藏的时候,内容区域的大小就不会发生变化。要做到这个效果,我们需要用到SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
这个标志。同时,你也有可能需要SYSTEM_UI_FLAG_LAYOUT_STABLE
这个标志来帮助你的应用维持一个稳定的布局。
当使用这种方法的时候,你就需要来确保应用中特定区域不会被系统栏掩盖(比如地图应用中一些自带的操作区域)。如果被覆盖了,应用可能就会无法使用。在大多数的情况下,你可以在布局文件中添加android:fitsSystemWindows
标签,设置它为true。它会调整父ViewGroup使它留出特定区域给系统栏,对于大多数应用这种方法就足够了。
在一些情况下,你可能需要修改默认的padding大小来获取合适的布局。为了控制内容区域的布局相对系统栏(它占据了一个叫做“内容嵌入”content insets
的区域)的位置,你可以重写fitSystemWindows(Rect insets)
方法。当窗口的内容嵌入区域发生变化时,fitSystemWindows()
方法会被view的hierarchy调用,让View做出相应的调整适应。重写这个方法你就可以按你的意愿处理嵌入区域与应用的布局。
三、隐藏导航栏
在4.0及以上版本中隐藏导航栏
你可以在Android 4.0以及以上版本,使用SYSTEM_UI_FLAG_HIDE_NAVIGATION
标志来隐藏导航栏。这段代码同时隐藏了导航栏和状态栏:
View decorView = getWindow().getDecorView();
// Hide both the navigation bar and the status bar.
// SYSTEM_UI_FLAG_FULLSCREEN is only available on Android 4.1 and higher, but as
// a general rule, you should design your app to hide the status bar whenever you
// hide the navigation bar.
int uiOptions = View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
| View.SYSTEM_UI_FLAG_FULLSCREEN;
decorView.setSystemUiVisibility(uiOptions);
注意以下几点
- 使用这个方法时,触摸屏幕的任何一个区域都会使导航栏(与状态栏)重新显示。用户的交互会使这个标签
SYSTEM_UI_FLAG_HIDE_NAVIGATION
被清除。 - 一旦这个标签被清除了,如果你想再次隐藏导航栏,你就需要重新对这个标签进行设定。在下一节响应UI可见性的变化中,将详细讲解应用监听系统UI变化来做出相应的调整操作。
- 在不同的地方设置UI标签是有所区别的。如果你在Activity的onCreate()方法中隐藏系统栏,当用户按下home键系统栏就会重新显示。当用户再重新打开activity的时候,onCreate()不会被调用,所以系统栏还会保持可见。如果你想让在不同Activity之间切换时,系统UI保持不变,你需要在onReasume()与onWindowFocusChaned()里设定UI标签。
- setSystemUiVisibility()仅仅在被调用的View显示的时候才会生效。
- 当从View导航到别的地方时,用setSystemUiVisibility()设置的标签会被清除。
2)让内容显示在导航栏之后
在Android 4.1与更高的版本中,你可以让应用的内容显示在导航栏的后面,这样当导航栏展示或隐藏的时候内容区域就不会发生布局大小的变化。可以使用SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
标签来做到这个效果。同时,你也有可能需要SYSTEM_UI_FLAG_LAYOUT_STABLE
这个标签来帮助你的应用维持一个稳定的布局。
四、全屏沉㓎式应用
五、响应UI可见性的变化
附:View.setSystemUiVisivility方法的参数的详细说明
View类提供了setSystemUiVisibility和getSystemUiVisibility方法,这两个方法实现对状态栏的动态显示或隐藏的操作,以及获取状态栏当前可见性。
setSystemUiVisibility(int visibility)方法可传入的实参为:
1. View.SYSTEM_UI_FLAG_VISIBLE:显示状态栏,Activity不全屏显示(恢复到有状态的正常情况)。
2. View.INVISIBLE:隐藏状态栏,同时Activity会伸展全屏显示。
3. View.SYSTEM_UI_FLAG_FULLSCREEN:Activity全屏显示,且状态栏被隐藏覆盖掉。
4. View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN:Activity全屏显示,但状态栏不会被隐藏覆盖,状态栏依然可见,Activity顶端布局部分会被状态遮住。
5. View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION:效果同View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
6. View.SYSTEM_UI_LAYOUT_FLAGS:效果同View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
7. View.SYSTEM_UI_FLAG_HIDE_NAVIGATION:隐藏虚拟按键(导航栏)。有些手机会用虚拟按键来代替物理按键。
8. View.SYSTEM_UI_FLAG_LOW_PROFILE:状态栏显示处于低能显示状态(low profile模式),状态栏上一些图标显示会被隐藏。