前言
在 Android 4.4 中引入了沉浸模式的功能,但这个版本非真正的沉浸模式,应该说是透明模式。Android 5.0 以后才可以在系统层面实现真正的沉浸式状态栏。沉浸式状态栏是为了与当前使用的 App 页面风格统一,不会显的那么突兀,保持友好且一致的用户体验而设计,是现在主流 App 必备的适配内容。今天我们就细细的研究一下沉浸式状态栏的适配。
上效果
先赞后看,更新永不断
实现的功能看实现代码状态栏设置为透明
/**
* 设置透明StatusBar
*
* @param activity Activity
*/
private static void setTranslucentStatusBar(Activity activity) {
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.KITKAT) {
return;
}
Window window = activity.getWindow();
//透明状态栏
window.setFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS, WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
//5.0及以上版本,创建 Navigation Bar
createNavBar(activity);
} else {
//4.4 版本设置为透明状态栏
window.addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
}
}
切换状态栏主题
这里主要是为了更好的适配页面背景,因为有的页面适合白色的状态栏图标,有的适合黑色的状态栏图标
/**
* Android 6.0使用原始的主题适配
*
* @param activity Activity
* @param darkMode 是否是黑色模式
*/
public static void setBarDarkMode(Activity activity, boolean darkMode) {
Window window = activity.getWindow();
if (window == null) {
return;
}
//设置StatusBar模式
if (darkMode) {//黑色模式
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {//设置statusBar和navigationBar为黑色
window.getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR | View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR);
} else {//设置statusBar为黑色
window.getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR);
}
}
} else {//白色模式

int statusBarFlag = View.SYSTEM_UI_FLAG_VISIBLE;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
statusBarFlag = window.getDecorView().getSystemUiVisibility()
& ~View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR;
}
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {//设置statusBar为白色,navigationBar为灰色
// int navBarFlag = window.getDecorView().getSystemUiVisibility()
// & ~View.SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR;//如果想让navigationBar为白色,那么就使用这个代码。
int navBarFlag = View.SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR;
window.getDecorView().setSystemUiVisibility(navBarFlag | statusBarFlag);
} else {
window.getDecorView().setSystemUiVisibility(statusBarFlag);
}
}
setHuaWeiStatusBar(darkMode, window);
}
白色黑色
设置 Bar 配色
现在是全面屏手机了,但是也可以设置开启虚拟导航栏的。这里主要是更改 Bar 在不同 Android 版本的配色,这里可以根据设计师的配色或者分装成接口使用。
/**
* 创建Navigation Bar
*
* @param activity 上下文
*/
@TargetApi(Build.VERSION_CODES.LOLLIPOP)
private static void createNavBar(Activity activity) {
int navBarHeight = getNavigationBarHeight(activity);
int navBarWidth = getNavigationBarWidth(activity);
if (navBarHeight > 0 && navBarWidth > 0) {
//创建NavigationBar
View navBar = new View(activity);
FrameLayout.LayoutParams pl;
if (activity.getResources().getConfiguration().orientation == Configuration.ORIENTATION_PORTRAIT) {
pl = new FrameLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, navBarHeight);
pl.gravity = Gravity.BOTTOM;
} else {
pl = new FrameLayout.LayoutParams(navBarWidth, ViewGroup.LayoutParams.MATCH_PARENT);
pl.gravity = Gravity.END;
}
navBar.setLayoutParams(pl);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
navBar.setBackgroundColor(Color.parseColor("#fffafafa"));
} else {
navBar.setBackgroundColor(Color.parseColor("#40000000"));
}
//添加到布局当中
ViewGroup decorView = (ViewGroup) activity.getWindow().getDecorView();
decorView.addView(navBar);
//设置主布局PaddingBottom
ViewGroup contentView = decorView.findViewById(android.R.id.content);
if (activity.getResources().getConfiguration().orientation == Configuration.ORIENTATION_PORTRAIT) {
contentView.setPaddingRelative(0, 0, 0, navBarHeight);
} else {
contentView.setPaddingRelative(0, 0, navBarWidth, 0);
}
}
}
修复 顶部白边的问题
在实际项目中我们可能会用到 ,但是设置了透明状态栏后,在 Android 4.4 上会出现顶部白边的问题,通过下面的方法可修复
/**
* 设置 DrawerLayout 在4.4版本下透明,不然会出现白边
*
* @param drawerLayout DrawerLayout
*/
public static void setTranslucentDrawerLayout(DrawerLayout drawerLayout) {
if (drawerLayout != null && Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT && Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP) {
drawerLayout.setFitsSystemWindows(true);
drawerLayout.setClipToPadding(false);
}
}
到这里我们已经看到了实现的核心方法,我已经封装了一个 ,方便项目中使用可以,下面我们介绍一下如何使用,并且你可以直接查看我编写好的 GitHub wiki
使用方法如何引用?
暂时不提供远程库引用的方式,只有一个类,点击下载 然后放到项目中即可,也方便自己扩展。
调用方法
AndroidBarUtils.setTranslucent(this);
//ToolBar、自定义的TitleBar 重叠问题以及适配刘海屏
AndroidBarUtils.setBarPaddingTop(this, view);
//false:白色 true:黑色
AndroidBarUtils.setBarDarkMode(this, false);
不常见问题
AndroidBarUtils.setTranslucentDrawerLayout(drawerLayout);
AndroidBarUtils.setBarPaddingTop(this,navigationView.getHeaderView(0));
最终效果
图片较大如果看不了,可以去 GitHub 上看哦
源码仓库总结
本文我们为了优化用户的 App 使用体验,一起查看了 Android 各个版本上沉浸式(透明)状态栏的实现细节,并适配了黑白状态栏主题以及 和 的异常情况。虽然是很小的一个优化的点,但是从页面美观和体验角度做了很大的提升。
参考:关于我
*请认真填写需求信息,我们会在24小时内与您取得联系。