前言
我們先一起來回顧一下實現沉浸式狀態列的一般套路。在Android上,關於對StatusBar(狀態列)的操作,一直都在不斷改善,並且表現越來越好,在Android4.4 以下,我們可以對StatusBar和 NavigationBar進行顯示和隱藏操作。但是直到Android4.4,我們才能真正意義上的實現沉浸式狀態列。從Android4.4 到現在(Android 9),關於沉浸式大概可以分成三個階段:
- Android4.4(API 19) - Android 5.0(API 21): 這個階段可以實現沉浸式,但是表現得還不是很好,實現方式為: 通過FLAG_TRANSLUCENT_STATUS設定狀態列為透明並且為全屏模式,然後通過新增一個與StatusBar 一樣大小的View,將View 的 background 設定為我們想要的顏色,從而來實現沉浸式。
- Android 5.0(API 21)以上版本: 在Android 5.0的時候,加入了一個重要的屬性和方法 android:statusBarColor (對應方法為 setStatusBarColor),通過這個方法我們就可以輕鬆實現沉浸式。也就是說,從Android5.0開始,系統才真正的支援沉浸式。
- Android 6.0(API 23)以上版本:其實Android6.0以上的實現方式和Android 5.0 +是一樣,為什麼要將它歸為一個單獨重要的階段呢?是因為從Android 6.0(API 23)開始,我們可以改狀態列的繪製模式,可以顯示白色或淺黑色的內容和圖示(除了魅族手機,魅族自家有做原始碼更改,6.0以下就能實現)。
總結:這三個階段的Android上API版本混亂,各種Flag林立。再加上各大廠商的定製化可謂是火上澆油,讓安卓開發者異常頭疼。
1.沉浸式三個階段使用
我們將從沉浸式支援的三個階段和支援的功能出發,去了解出現的相關背景,然後去了解怎麼實現三個階段的沉浸式。
1.1 Android4.0-Android5.0設定沉浸體驗
在android4.4及以上版本中為 setSystemUiVisibility() 方法引入了一個新的flag:SYSTEM_UI_FLAG_IMMERSIVE,它可以使你的app實現真正意義上的全屏體驗。當SYSTEM_UI_FLAG_IMMERSIVE、SYSTEM_UI_FLAG_HIDE_NAVIGATION 和SYSTEM_UI_FLAG_FULLSCREEN三個flag一起使用的時候,可以隱藏狀態列與導航欄,同時讓你的app可以捕捉到使用者的所有觸控式螢幕事件。從Android4.4以上版本才是真正的可以設定沉浸式體驗,但也僅僅是操作狀態列和導航欄的顯示與隱藏。
1.1.1 FLAG_TRANSLUCENT_STATUS
當沉浸式全屏模式啟用的時候,你的activity會繼續接受各類的觸控事件。使用者可以通過在狀態列與導航欄原來區域的邊緣向內滑動讓系統欄重新顯示。這個操作清空了SYSTEM_UI_FLAG_HIDE_NAVIGATION和SYSTEM_UI_FLAG_FULLSCREEN,如果沒有兩個標誌的話,系統欄重新變得可見。如果設定了兩個標籤的話,這個操作同時也觸發了View.OnSystemUiVisibilityChangeListener。然而, 如果你想讓系統欄在一段時間後自動隱藏的話,你應該使用SYSTEM_UI_FLAG_IMMERSIVE_STICKY標籤。
展示了各種不同的“沉浸式”狀態
在上圖中:
- 非沉浸模式 —— 展示了應用進入沉浸模式之前的狀態。也展示了設定IMMERSIVE標籤後使用者滑動展示系統欄的狀態。使用者滑動後,SYSTEM_UI_FLAG_HIDE_NAVIGATION和SYSTEM_UI_FLAG_FULLSCREEN就會被清除,系統欄就會重新顯示並保持可見。請注意,最好的方式就是讓所有的UI控制元件與系統欄的顯示隱藏保持同步,這樣可以減少螢幕顯示所處的狀態,同時提供了更無縫平滑的使用者體驗。因此所有的UI控制元件跟隨系統欄一同顯示。一旦應用進入了沉浸模式,UI控制元件也跟隨著系統欄一同隱藏。為了確保UI的可見性與系統欄保持一致,我們需要一個監聽器View.OnSystemUiVisibilityChangeListener來監聽系統欄的變化。這在下一節中將詳細講解。
- 提示氣泡——第一次進入沉浸模式時,系統將會顯示一個提示氣泡,提示使用者如何再讓系統欄顯示出來。請注意,如果為了測試你想強制顯示提示氣泡,你可以先將應用設為沉浸模式,然後按下電源鍵進入鎖屏模式,並在5秒中之後開啟螢幕。
- 沉浸模式—— 這張圖展示了隱藏了系統欄和其他UI控制元件的狀態。你可以設定IMMERSIVE和IMMERSIVE_STICKY來進入這個狀態。
- 粘性標籤——這就是你設定了IMMERSIVE_STICKY標籤時的UI狀態,使用者會向內滑動以展示系統欄。半透明的系統欄會臨時的進行顯示,一段時間後自動隱藏。滑動的操作並不會清空任何標籤,也不會觸發系統UI可見性的監聽器,因為暫時顯示的導航欄並不被認為是一種可見的狀態。
注意,immersive類的標籤只有在與SYSTEM_UI_FLAG_HIDE_NAVIGATION,SYSTEM_UI_FLAG_FULLSCREEN中一個或兩個一起使用的時候才會生效。你可以只使用其中的一個,但是一般情況下你需要同時隱藏狀態列和導航欄以達到沉浸的效果。
1.1.2 兩種使用這個屬性的方式:
- 在使用時候,我們通常需要考慮的是狀態列一值顯示在頂部而不會隱藏或者被遮擋(其他app情況如:讀書app或者是遊戲app則需要隱藏頂部狀態列),所以只需要通過程式碼設定FLAG_TRANSLUCENT_STATU:
activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
- 通過主題theme設定屬性windowTranslucentStatus:
<style name="Theme" parent="Theme.Design.Light.NoActionBar">
<item name="android:windowTranslucentStatus">true</item>
</style>
效果如下:
效果如上圖,可以看出,沉浸式的效果是出來了,但是也有一個問題,我們的標題欄和狀態列重疊了,相當於整個佈局上移了StatusBar 的高度。
為了讓標題欄回到原來的位置並且適應標題欄的顏色,我們在標題欄的上方新增一個大小和StatusBar大小一樣假的狀態列View,View 的BackgroundColor 可以自己設定成標題欄一樣的顏色也可以是其他顏色,這個View起到一個佔位的作用。這個時候,標題欄就會下移StatusBar的高度,回到正常的位置。
通過設定paddingTop重新繪製標題欄高度程式碼如下:
View statusBarView = mDecorView.findViewById(IMMERSION_STATUS_BAR_VIEW);
if (statusBarView == null) {
statusBarView = new View(mActivity);
FrameLayout.LayoutParams params = new FrameLayout.LayoutParams(FrameLayout.LayoutParams.MATCH_PARENT,
mBarConfig.getStatusBarHeight());
params.gravity = Gravity.TOP;
statusBarView.setLayoutParams(params);
statusBarView.setVisibility(View.VISIBLE);
statusBarView.setId(IMMERSION_STATUS_BAR_VIEW);
mDecorView.addView(statusBarView);
}
if (mBarParams.statusBarColorEnabled) {
statusBarView.setBackgroundColor(ColorUtils.blendARGB(mBarParams.statusBarColor,
mBarParams.statusBarColorTransform, mBarParams.statusBarAlpha));
} else {
statusBarView.setBackgroundColor(ColorUtils.blendARGB(mBarParams.statusBarColor,
Color.TRANSPARENT, mBarParams.statusBarAlpha));
}
新增上述程式碼後,效果如下:
通過以上就可以實現Android 4.4 上的沉浸式狀態列。
小結:Android4.4-Android5.0的步驟就是為window新增FLAG_TRANSLUCENT_STATUS的Flag,然後新增一個假的狀態列,通過上述方法設定的沉浸式在Android4.4-Android5.0之間的效果如貼圖,狀態列頂部是有一個黑色陰影漸變,在5.0版本版本以上被修復了。
如果是一張圖片沉浸到狀態列則不需要設定這個假的狀態列,只需要設定,FLAG_TRANSLUCENT_STATUS就OK。並且在Android4.4-Android5.0是沒有提供改變狀態顏色的屬性,所以只能通過新增加一個假的狀態列方式改變背景顏色。
1.2 Android5.0以上設定狀態列背景顏色
Android 5.0 是一個里程碑式的版本,從Android 5.0開始,Google 推出了全新的設計規範 Material Design,並且原生控制元件就可以實現一些炫酷的UI動效。從這個版本開始,google 加入了一個比較重要的方法setStatusBarColor (對應屬性:android:statusBarColor),通過這個方法,可以很輕鬆地實現沉浸式狀態列。方法如下
public abstract void setStatusBarColor(@ColorInt int color);
注意看這個方法的註釋,想要這個方法生效,必須還要配合一個Flag一起使用,必須設定FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS ,並且不能設定FLAG_TRANSLUCENT_STATUS(Android 4.4才用這個),所以和4.4互斥不能共用。所以Android5.0以上可以設定狀態列和導航欄字型顏色。
1.2.1 FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS屬性
解釋:設定了FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS,表明會Window負責系統bar的background 繪製,繪製透明背景的系統bar(狀態列和導航欄),然後用getStatusBarColor()和getNavigationBarColor()的顏色填充相應的區域。這就是Android 5.0 以上實現沉浸式導航欄的原理。
實現沉浸式新增如下程式碼:
getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
//注意要清除 FLAG_TRANSLUCENT_STATUS flag
getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
getWindow().setStatusBarColor(getResources().getColor(android.R.color.holo_red_light));
效果如下:
如果在開發的時候是通過設定主題的方式設定,則需要在values-v21資料夾下新增如下主題,達到相容目的
<style name="Theme" parent="Theme.Design.Light.NoActionBar">
<item name="android:windowTranslucentStatus">false</item>
<item name="android:windowDrawsSystemBarBackgrounds">true</item>
<item name="android:statusBarColor">@android:color/holo_red_light</item>
</style>
1.2.2 圖片延伸到狀態列
在Android 5.0 使圖片延伸到狀態列,只需設定windowTranslucentStatus,將 statusBarColor 設定為透明即可。
主題方式設定如下:
<style name="ImageTranslucentTheme" parent="Theme.AppCompat.DayNight.NoActionBar">
<item name="android:windowTranslucentNavigation">true</item>
<item name="android:windowTranslucentStatus">true</item>
<!-- 設定statusBarColor 為透明-->
<item name="android:statusBarColor">@android:color/transparent</item>
</style>
在開發過程中,使用程式碼設定windowTranslucentStatus需要通過版本號的判斷相容 Android5.0以下和Android 5.0以上。
1.3 Android 6.0 +實現狀態列字色和圖示淺黑色
使用Android6.0以下版本沉浸式的時候會遇到一個問題,那就是Android 系統狀態列的字色和圖示顏色為白色,當狀態列顏色接近淺色的時候,狀態列上的內容就看不清了。Android 6.0 新新增了一個屬性來解決這個問題,屬性是SYSTEM_UI_FLAG_LIGHT_STATUS_BAR。
1.3.1 SYSTEM_UI_FLAG_LIGHT_STATUS_BAR
解釋:為setSystemUiVisibility(int)方法新增的Flag,請求status bar 繪製模式,它可以相容亮色背景的status bar 。要在設定了FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDSflag ,同時清除了FLAG_TRANSLUCENT_STATUSflag 才會生效。
通過程式碼設定:
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
getWindow().getDecorView().setSystemUiVisibility(
View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN|View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR);
}
效果如下
並且還可以在主題中使用屬性,並且該主題需要放在values-v23資料夾下相應Android6.0以上才能生效:
<style name="Theme" parent="Theme.Design.Light.NoActionBar">
<item name="android:windowTranslucentStatus">false</item>
<item name="android:windowDrawsSystemBarBackgrounds">true</item>
<item name="android:statusBarColor">@android:color/holo_red_light</item>
<!-- Android 6.0以上 狀態列字色和圖示為淺黑色-->
<item name="android:windowLightStatusBar">true</item>
</style>
2. ZanImmersionBar輪子的原理和使用
在實際開發過程中,我們不僅僅只會遇到以上三種版本相容問題,還需要考慮如:不同手機品牌,動態該狀態列背景,以及Fragment中需要有自己的狀態列顏色場景。所以需要綜合考慮多種場景,達到能適配多種開發情況的要求。
總結出以下場景:
綜合以上場景並且參考github例子進行封裝之後得到了ZanImmersionBar這個輪子
2.1 原理:
我們希望將設定沉浸式效果都封裝在一個類裡面,想達到所有的效果通過一個方法設定,但很多的效果中都會有重複的設定步驟,並且每個效果的方法太多則分不清使用哪個,所以將設定沉浸式效果拆分成幾個步驟,而想要設定個性效果,通過方法設定引數,最後通過init方法收集所有引數讓後統一設定引數屬性。
ZanImmersionBar.with(this).init();//該方法將進行以下步驟處理沉浸式
public void init() {
//更新Bar的引數
updateBarParams();
//設定沉浸式
setBar();
//適配狀態列與佈局重疊問題
fitsLayoutOverlap();
//適配軟鍵盤與底部輸入框衝突問題
fitsKeyboard();
//變色view
transformView();
}
沉浸式設定流程如下圖:
這幾個步驟其中,獲取引數和設定沉浸式是必須經過,下面三種設定是在開發中可能遇到的情況,也是設定引數,如果匹配到了則會進行三種設定的處理,接下來主要分析下第一個步驟和第二步驟。
2.1.1 收集bar引數
我們使用一個物件用於儲存使用者設定的bar引數,這些引數有狀態列和導航欄顏色、透明度、顯示隱藏等等,通過該物件中的引數來分別設定
public class BarParams implements Cloneable {
/**
* 狀態列顏色
*/
@ColorInt
int statusBarColor = Color.TRANSPARENT;
/**
* 導航欄顏色
*/
@ColorInt
int navigationBarColor = Color.BLACK;
/**
* The Default navigation bar color.
*/
int defaultNavigationBarColor = Color.BLACK;
/**
* 狀態列透明度
*/
@FloatRange(from = 0f, to = 1f)
float statusBarAlpha = 0.0f;
/**
* 導航欄透明度
*/
@FloatRange(from = 0f, to = 1f)
float navigationBarAlpha = 0.0f;
//等其他屬性
...
}
而這些屬性可以通過以下ZanImmersionBar提供的方法進行個性化設定,而這些方法只是將需要設定的引數新增到BarParams物件中,最後必須呼叫init將引數設定上去。
ZanImmersionBar.with(this)
.transparentStatusBar() //透明狀態列,不寫預設透明色
.transparentNavigationBar() //透明導航欄,不寫預設黑色(設定此方法,fullScreen()方法自動為true)
.transparentBar() //透明狀態列和導航欄,不寫預設狀態列為透明色,導航欄為黑色(設定此方法,fullScreen()方法自動為true)
.statusBarColor(R.color.colorPrimary) //狀態列顏色,不寫預設透明色
.navigationBarColor(R.color.colorPrimary) //導航欄顏色,不寫預設黑色
.barColor(R.color.colorPrimary) //同時自定義狀態列和導航欄顏色,不寫預設狀態列為透明色,導航欄為黑色
.statusBarAlpha(0.3f) //狀態列透明度,不寫預設0.0f
.navigationBarAlpha(0.4f) //導航欄透明度,不寫預設0.0F
.barAlpha(0.3f) //狀態列和導航欄透明度,不寫預設0.0f
.statusBarDarkFont(true) //狀態列字型是深色,不寫預設為亮色
.navigationBarDarkIcon(true) //導航欄圖示是深色,不寫預設為亮色
//等一些其他方法
.init(); //必須呼叫方可沉浸式
設定完引數後,則需要收集這些引數,如果在Fragment中使用,則需要Activity同步Fragment的BarParams引數
//獲得Bar相關資訊
//如果在Fragment中使用,讓Activity同步Fragment的BarParams引數
if (mIsFragment) {
ZanImmersionBar immersionBar = mImmersionBarMap.get(mActivity.toString());
if (immersionBar != null) {
immersionBar.mBarParams = mBarParams;
}
}
mImmersionBarMap是個Map,用於儲存每個Activity對應的ZanImmersionBar物件
- 原理:其實我們通過沉浸式三代發展史,我們可以知道設定沉浸式都是通過改變Activity的window屬性達到沉浸式,所以我們想要在Fragment的定製化沉浸式,其實是通過改變Activity的BarParams引數再設定Activity的沉浸式,所以需要注意對Fragment設定沉浸式前必須保證載入Fragment的Activity先進行了ZanImmersionBar的init初始化。
- 另例:需要注意dialogFragment和Dialog是有自己的window,該window是屬於所屬Activity的子window,所以設定dialogFragment和Dialog的沉浸式改變的是自己window裡的屬性,而不是改變Actvity的window裡的屬性。
-
關閉銷燬:在activity的onDestroy方法中執行,因為mImmersionBarMap儲存了每個Activity對應的ZanImmersionBar物件,所以當Activity關閉了需要及時釋放,不然mImmersionBarMap會存在過多無用的ZanImmersionBar物件。
ZanImmersionBar.with(this).destroy(); //必須呼叫該方法,防止記憶體洩漏 public void destroy() { //取消監聽 cancelListener(); //刪除當前介面對應的ImmersionBar物件 Iterator<Map.Entry<String, ZanImmersionBar>> iterator = mImmersionBarMap.entrySet().iterator(); while (iterator.hasNext()) { Map.Entry<String, ZanImmersionBar> entry = iterator.next(); if (entry.getKey().contains(mImmersionBarName) || (entry.getKey().equals(mImmersionBarName))) { iterator.remove(); } } }
2.1.2 初始化狀態列和導航欄
該方法則是將上一步的引數進行初始化,初始化過程則會根據沉浸式三個階段和不同廠商進行區分設定。需要注意小米手機系統有自己定製化設定的屬性,所以需要分割槽設定
private void setBar() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP && !OSUtils.isEMUI3_x()) {
//適配劉海屏
fitsNotchScreen();
//初始化5.0以上,包含5.0
uiFlags = initBarAboveLOLLIPOP(uiFlags);
//android 6.0以上設定狀態列字型為暗色
uiFlags = setStatusBarDarkFont(uiFlags);
//android 8.0以上設定導航欄圖示為暗色
uiFlags = setNavigationIconDark(uiFlags);
} else {
//初始化5.0以下,4.4以上沉浸式
initBarBelowLOLLIPOP();
}
...
}
if (OSUtils.isMIUI6Later()) {
//修改miui狀態列字型顏色
setMIUIBarDark(mWindow, MIUI_STATUS_BAR_DARK, mBarParams.statusBarDarkFont);
//修改miui導航欄圖示為黑色
if (mBarParams.navigationBarEnable) {
setMIUIBarDark(mWindow, MIUI_NAVIGATION_BAR_DARK, mBarParams.navigationBarDarkIcon);
}
}
...
}
我們可以重點看下5.0以上狀態列和導航欄初始化,設定初始化window屬性讓後設定導航欄和狀態列顏色
@RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
private int initBarAboveLOLLIPOP(int uiFlags) {
//Activity全屏顯示,但狀態列不會被隱藏覆蓋,狀態列依然可見,Activity頂端佈區域性分會被狀態列遮住。
uiFlags |= View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN;
mWindow.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
//判斷是否存在導航欄
if (mBarConfig.hasNavigationBar()) {
mWindow.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION);
}
//需要設定這個才能設定狀態列和導航欄顏色
mWindow.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
//設定狀態列顏色
if (mBarParams.statusBarColorEnabled) {
mWindow.setStatusBarColor(ColorUtils.blendARGB(mBarParams.statusBarColor,
mBarParams.statusBarColorTransform, mBarParams.statusBarAlpha));
} else {
mWindow.setStatusBarColor(ColorUtils.blendARGB(mBarParams.statusBarColor,
Color.TRANSPARENT, mBarParams.statusBarAlpha));
}
...
return uiFlags;
}
通過程式碼分析可以看到其實ZanImmersionBar所做的事情就是將設定沉浸式方法進行步驟拆分和增加個性屬性設定,並且將沉浸式三個階段和不同廠商進行區分獨立方法設定呼叫。
2.2 建議和使用
- 建議在BaseActivity中初始化和銷燬
public class BaseActivity extends AppCompatActivity {
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// 所有子類都將繼承這些相同的屬性,請在設定介面之後設定
ZanImmersionBar.with(this).init();
}
@Override
protected void onDestroy() {
super.onDestroy();
// 必須呼叫該方法,防止記憶體洩漏
ZanImmersionBar.with(this).destroy();
}
}
- 展示Activity中使用效果
2.3在Fragment使用ZanImmersionBar
注意在Fragment中使用ZanImmersionBar需要在承載的Activity中初始化ZanImmersionBar,不然會丟擲異常
public abstract class BaseFragment{
@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
super.onViewCreated(view, savedInstanceState);
initImmersionBar();
}
@Override
public void initImmersionBar() {
ZanImmersionBar.with(this).keyboardEnable(true).init();
}
}
具體的Fragment呼叫以下方法:
@Override
public void initImmersionBar() {
super.initImmersionBar();
ZanImmersionBar.with(this)
.statusBarDarkFont(true)
.statusBarColor(R.color.btn1)
.navigationBarColor(R.color.btn1)
.init();
}
- 設定Fragment的狀態列顏色和狀態列字型顏色效果
2.4 在Dialog中實現沉浸式
在Dialog中設定ZanImmersionBar方式和在Fragment或者Activity一樣,如果在Fragment或者Activity中有設定並且dialog出現不需要改變狀態列則不用設定ZanImmersionBar,如果需要做定製化上面的高階用法在Dialog也支援
- 結合dialogFragment中使用
ZanImmersionBar.with(this).init();
- 其他dialog
ZanImmersionBar.with(this, dialog).init();
2.5 在PopupWindow中實現沉浸式
重點是呼叫以下方法,但是此方法會導致有導航欄的手機底部佈局會被導航欄覆蓋,還有底部輸入框無法根據軟鍵盤彈出而彈出。這個屬性在頂部彈出的時候是需要使用,如果是底部彈框需要看情況而定。
popupWindow.setClippingEnabled(false);
2.6 狀態列與佈局頂部重疊解決方案,六種方案任選其一(可選)
正常使用ZanImmersionBar一般不需要考慮重疊問題但在專案中接入ZanImmersionBar並且頁面沒有考慮給頭部控制元件預留出狀態列的高度,並且需要將頁面內容沉浸到狀態列或者做定製化狀態列,這種情況下需要考慮重疊問題。之前說到Android4.4版本的時候解決重疊的方式是一種,也可以參考一下幾種方式解決狀態列與佈局頂部重疊問題。
- ① 使用dimen自定義狀態列高度,不建議使用,因為裝置狀態列高度並不是固定的
在values-v19/dimens.xml檔案下
<dimen name="status_bar_height">25dp</dimen>
在values/dimens.xml檔案下
<dimen name="status_bar_height">0dp</dimen>
然後在佈局介面新增view標籤,高度指定為status_bar_height
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@color/darker_gray"
android:orientation="vertical">
<View
android:layout_width="match_parent"
android:layout_height="@dimen/status_bar_height"
android:background="@color/colorPrimary" />
<android.support.v7.widget.Toolbar
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="@color/colorPrimary"
app:title="方法一"
app:titleTextColor="@android:color/white" />
</LinearLayout>
- ② 使用系統的fitsSystemWindows屬性,使用該屬性不會導致輸入框與軟鍵盤衝突問題,不要再Fragment使用該屬性
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
android:fitsSystemWindows="true">
</LinearLayout>
然後使用ImmersionBar時候必須指定狀態列顏色
ZanImmersionBar.with(this)
.statusBarColor(R.color.colorPrimary)
.init();
注意:ZanImmersionBar一定要在設定完佈局以後使用
- ③ 使用ZanImmersionBar的fitsSystemWindows(boolean fits)方法
ZanImmersionBar.with(this)
.fitsSystemWindows(true) //使用該屬性,必須指定狀態列顏色
.statusBarColor(R.color.colorPrimary)
.init();
- ④ 使用ZanImmersionBar的statusBarView(View view)方法
在標題欄的上方增加View標籤,高度指定為0dp
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@color/darker_gray"
android:orientation="vertical">
<View
android:layout_width="match_parent"
android:layout_height="0dp"
android:background="@color/colorPrimary" />
<android.support.v7.widget.Toolbar
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="@color/colorPrimary"
app:title="方法四"
app:titleTextColor="@android:color/white" />
</LinearLayout>
然後使用ZanImmersionBar的statusBarView方法,指定view就可以啦
ZanImmersionBar.with(this)
.statusBarView(view)
.init();
//或者
//ZanImmersionBar.setStatusBarView(this,view);
- ⑤ 使用ZanImmersionBar的titleBar(View view)方法,原理是設定paddingTop
ZanImmersionBar.with(this)
.titleBar(view) //可以為任意view,如果是自定義xml實現標題欄的話,最外層節點不能為RelativeLayout
.init();
//或者
//ZanImmersionBar.setTitleBar(this, view);
- ⑥ 使用ZanImmersionBar的titleBarMarginTop(View view)方法,原理是設定marginTop
ZanImmersionBar.with(this)
.titleBarMarginTop(view) //可以為任意view
.statusBarColor(R.color.colorPrimary) //指定狀態列顏色,根據情況是否設定
.init();
//或者使用靜態方法設定
//ZanImmersionBar.setTitleBarMarginTop(this,view);
總結
在處理Android沉浸式狀態列和導航欄開始會很頭大,並且會不理解相關設定的window的FLAG屬性,想要分清楚這些屬性的大意需要從出現背景出發拆封,先熟悉沉浸式出現的3個階段的屬性和版本能做什麼和不能做什麼,然後再去了解各個廠家定製化的屬性在哪些版本階段使用,以及是否需要對異形屏適配,最後才是在實際開發和需求中對狀態列和導航欄處理。不過在Android6.0以後版本廠家的定製化狀態已經越來越沒有意義了,以後Android原生趨勢也將會讓開發者使用沉浸式越來越舒服。