Android 沉浸式狀態列實踐
摘要：
首先明確一下沉浸式狀態列的概念有兩種型別
頂部是ImageView這種需要將其填充到狀態列
image.png
頂部是ActionBar這種不需要填充到狀態列
...
首先明確一下沉浸式狀態列的概念有兩種型別
-
頂部是ImageView這種需要將其填充到狀態列
image.png
-
頂部是ActionBar這種不需要填充到狀態列
image.png
而上面的第二種情況覆蓋了絕大部分頁面，所以下面的思路也是基於這點來實現。
第一步：
在BaseActivity裡面實現如下程式碼
public abstract class BaseActivity extends AppCompatActivity{
@Override
protected final void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setStatusBar();
}
protected void setStatusBar() {
//這裡做了兩件事情，1.使狀態列透明並使contentView填充到狀態列 2.預留出狀態列的位置，防止介面上的控制元件離頂部靠的太近。這樣就可以實現開頭說的第二種情況的沉浸式狀態列了
StatusBarUtil.setTransparent(this);
}
}
看下 StatusBarUtil.setTransparent(this) 具體的實現
/**
* 設定狀態列全透明
*
* @param activity 需要設定的activity
*/
public static void setTransparent(Activity activity) {
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.KITKAT) {
return;
}
transparentStatusBar(activity);
setRootView(activity);
}
/**
* 使狀態列透明
*/
@TargetApi(Build.VERSION_CODES.KITKAT)
private static void transparentStatusBar(Activity activity) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
activity.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
//需要設定這個flag contentView才能延伸到狀態列
activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION);
//狀態列覆蓋在contentView上面，設定透明使contentView的背景透出來
activity.getWindow().setStatusBarColor(Color.TRANSPARENT);
} else {
//讓contentView延伸到狀態列並且設定狀態列顏色透明
activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
}
}
/**
* 設定根佈局引數
*/
private static void setRootView(Activity activity) {
ViewGroup parent = (ViewGroup) activity.findViewById(android.R.id.content);
for (int i = 0, count = parent.getChildCount(); i < count; i++) {
View childView = parent.getChildAt(i);
if (childView instanceof ViewGroup) {
childView.setFitsSystemWindows(true);
((ViewGroup) childView).setClipToPadding(true);
}
}
}
經過這樣的設定基本上大部分介面都適配了沉浸式狀態列了，針對需要適配imageView填充到狀態列或者需要單獨設定狀態列顏色和透明度的我們可以在BaseActivity 的子類重寫setStatusBar方法來單獨適配。
第二步：
- 先說簡單的，單獨設定狀態列顏色和透明度這種情況
//重寫這個方法
protected void setStatusBar() {
StatusBarUtil.setColor(...);
}
/**
* 設定狀態列顏色
*
* @param activity需要設定的activity
* @param color狀態列顏色值
* @param statusBarAlpha 狀態列透明度
*/
public static void setColor(Activity activity, @ColorInt int color, @IntRange(from = 0, to = 255) int statusBarAlpha) {
//5.0以上版本直接設定狀態列顏色透明度
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
activity.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
activity.getWindow().setStatusBarColor(calculateStatusColor(color, statusBarAlpha));
//4.4-5.0版本通過偽裝一個狀態列來設定顏色和透明度
} else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
ViewGroup decorView = (ViewGroup) activity.getWindow().getDecorView();
View fakeStatusBarView = decorView.findViewById(FAKE_STATUS_BAR_VIEW_ID);
if (fakeStatusBarView != null) {
if (fakeStatusBarView.getVisibility() == View.GONE) {
fakeStatusBarView.setVisibility(View.VISIBLE);
}
fakeStatusBarView.setBackgroundColor(calculateStatusColor(color, statusBarAlpha));
} else {
decorView.addView(createStatusBarView(activity, color, statusBarAlpha));
}
setRootView(activity);
}
}
/**
* 計算狀態列顏色
*
* @param color color值
* @param alpha alpha值
* @return 最終的狀態列顏色
*/
private static int calculateStatusColor(@ColorInt int color, int alpha) {
if (alpha == 0) {
return color;
}
float a = 1 - alpha / 255f;
int red = color >> 16 & 0xff;
int green = color >> 8 & 0xff;
int blue = color & 0xff;
red = (int) (red * a + 0.5);
green = (int) (green * a + 0.5);
blue = (int) (blue * a + 0.5);
return 0xff << 24 | red << 16 | green << 8 | blue;
}
/**
* 生成一個和狀態列大小相同的半透明矩形條
*
* @param activity 需要設定的activity
* @param color狀態列顏色值
* @param alpha透明值
* @return 狀態列矩形條
*/
private static View createStatusBarView(Activity activity, @ColorInt int color, int alpha) {
// 繪製一個和狀態列一樣高的矩形
View statusBarView = new View(activity);
LinearLayout.LayoutParams params =
new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, getStatusBarHeight(activity));
statusBarView.setLayoutParams(params);
statusBarView.setBackgroundColor(calculateStatusColor(color, alpha));
statusBarView.setId(FAKE_STATUS_BAR_VIEW_ID);
return statusBarView;
}
/**
* 獲取狀態列高度
*
* @param context context
* @return 狀態列高度
*/
public static int getStatusBarHeight(Context context) {
// 獲得狀態列高度
int resourceId = context.getResources().getIdentifier("status_bar_height", "dimen", "android");
return context.getResources().getDimensionPixelSize(resourceId);
}
- imageView這種需要填充到狀態列的情況
//重寫這個方法
protected void setStatusBar() {
StatusBarUtil.setTransparentForImageView(...);
}
/**
* 為頭部是 ImageView 的介面設定狀態列全透明
*
* @param activity需要設定的activity
* @param needOffsetView 需要向下偏移的 View
*/
public static void setTransparentForImageView(Activity activity, View needOffsetView) {
setTranslucentForImageView(activity, 0, needOffsetView);
}
/**
* 為頭部是 ImageView 的介面設定狀態列透明
*
* @param activity需要設定的activity
* @param statusBarAlpha 狀態列透明度
* @param needOffsetView 需要向下偏移的 View
*/
public static void setTranslucentForImageView(Activity activity, @IntRange(from = 0, to = 255) int statusBarAlpha,
View needOffsetView) {
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.KITKAT) {
return;
}
setTransparentForWindow(activity);
addTranslucentView(activity, statusBarAlpha);
//雖然imageView需要填充到狀態列，但是上面的文字按鈕等控制元件並不需要填充到狀態列，所以需要設定偏移
if (needOffsetView != null) {
Object haveSetOffset = needOffsetView.getTag(TAG_KEY_HAVE_SET_OFFSET);
if (haveSetOffset != null && (Boolean) haveSetOffset) {
return;
}
ViewGroup.MarginLayoutParams layoutParams = (ViewGroup.MarginLayoutParams) needOffsetView.getLayoutParams();
layoutParams.setMargins(layoutParams.leftMargin, layoutParams.topMargin + getStatusBarHeight(activity),
layoutParams.rightMargin, layoutParams.bottomMargin);
needOffsetView.setTag(TAG_KEY_HAVE_SET_OFFSET, true);
}
}
/**
* 設定透明
*/
private static void setTransparentForWindow(Activity activity) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
activity.getWindow().setStatusBarColor(Color.TRANSPARENT);
activity.getWindow()
.getDecorView()
//兩個 flag 要結合使用，表示讓應用的主體內容佔用系統狀態列的空間
.setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_STABLE | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN);
} else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
activity.getWindow()
.setFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS, WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
}
}
/**
* 新增半透明矩形條
*
* @param activity需要設定的 activity
* @param statusBarAlpha 透明值
*/
private static void addTranslucentView(Activity activity, @IntRange(from = 0, to = 255) int statusBarAlpha) {
ViewGroup contentView = (ViewGroup) activity.findViewById(android.R.id.content);
View fakeTranslucentView = contentView.findViewById(FAKE_TRANSLUCENT_VIEW_ID);
if (fakeTranslucentView != null) {
if (fakeTranslucentView.getVisibility() == View.GONE) {
fakeTranslucentView.setVisibility(View.VISIBLE);
}
fakeTranslucentView.setBackgroundColor(Color.argb(statusBarAlpha, 0, 0, 0));
} else {
contentView.addView(createTranslucentStatusBarView(activity, statusBarAlpha));
}
}
/**
* 建立半透明矩形 View
*
* @param alpha 透明值
* @return 半透明 View
*/
private static View createTranslucentStatusBarView(Activity activity, int alpha) {
// 繪製一個和狀態列一樣高的矩形
View statusBarView = new View(activity);
LinearLayout.LayoutParams params =
new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, getStatusBarHeight(activity));
statusBarView.setLayoutParams(params);
statusBarView.setBackgroundColor(Color.argb(alpha, 0, 0, 0));
statusBarView.setId(FAKE_TRANSLUCENT_VIEW_ID);
return statusBarView;
}
最後小結一下思路：
首先在基類設定狀態列透明，讓contentView填充到狀態列，利用contentView的背景作為狀態列背景直接實現沉浸的效果，然後利用setFitsSystemWindows(true)和setClipToPadding(true)對控制元件預留出狀態列的位置。
如果需要單獨設定狀態列顏色或者透明度，比如contentView的背景色和ActionBar背景不一致的情況，5.0以上通過設定setStatusBarColor實現，4.4-5.0通過偽裝狀態列實現。
最後如果需要實現類似圖片這種需要填充到狀態列的情況，通過setTransparentForWindow實現，然後對其他控制元件重設MarginLayoutParams來實現預留出狀態列位置的效果。
經過上面的一些設定已經覆蓋了絕大部分情況，對於Fragment，DrawerLayout，CoordinatorLayout等可能需要特殊處理的這裡貼上gitgub地址。 ps：作者不是我，我只是個搬磚的。
ofollow,noindex">https://github.com/laobie/StatusBarUtil