Android透明狀態(tài)欄總結(jié)

去年曾對(duì)狀態(tài)欄進(jìn)行了一次總結(jié)，具體見(jiàn)安卓自定義StatusBar-布局內(nèi)容延展及沉浸式狀態(tài)欄實(shí)現(xiàn)。近期再一次做透明狀態(tài)欄相關(guān)的工作，加深了對(duì)狀態(tài)欄的理解。所以決定再做一次總結(jié)，爭(zhēng)取能做到通熟易懂。

先提幾個(gè)關(guān)鍵詞。Transparent（透明的）、Translucent（半透明）、Immersive（沉浸式）

首先聊下沉浸式這個(gè)詞，它指給用戶(hù)提供完全沉浸的體驗(yàn)。沉浸式狀態(tài)欄的叫法是錯(cuò)誤的，應(yīng)該是一種沉浸式的模式。它要求隱藏狀態(tài)欄，使屏幕全屏，常應(yīng)用在游戲，視頻播放場(chǎng)景。具體可參考郭霖的博客Android狀態(tài)欄微技巧，帶你真正理解沉浸式模式.

關(guān)于狀態(tài)欄，比較常見(jiàn)的效果如下：


圖1

圖2

設(shè)置狀態(tài)欄顏色

圖1和圖2的狀態(tài)欄顏色不同。實(shí)現(xiàn)的思路如下：
1、android 5.0及以上版本

window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
window.setStatusBarColor(int);

其中，5.0版本的FLAG_TRANSLUCENT_STATUS是全透明的，但是6.0上卻是半透明的。若要實(shí)現(xiàn)圖1的效果，則需要直接設(shè)置statusbar的顏色。
2、android 4.4版本
通過(guò)設(shè)置狀態(tài)欄為透明，將應(yīng)用布局延展到狀態(tài)欄下面。然后在布局里構(gòu)造一個(gè)同狀態(tài)欄同尺寸的view，對(duì)view設(shè)置背景顏色即可。

//設(shè)置透明狀態(tài)欄
window.addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
//取消透明狀態(tài)欄
window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);

注意，4.4版本的透明效果如下圖，頂部有一個(gè)黑色的半透明過(guò)渡。


image.png

實(shí)現(xiàn)代碼如下：

/**
     * 設(shè)置狀態(tài)欄顏色
     *
     * @param activity       需要設(shè)置的activity
     * @param color          狀態(tài)欄顏色值
     * @param statusBarAlpha 狀態(tài)欄透明度
     */

    public static void setColor(Activity activity, @ColorInt int color, @IntRange(from = 0, to = 255) int statusBarAlpha) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
            //
            activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
            //取消透明狀態(tài)欄，contentView不再與狀態(tài)欄重疊
            activity.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
            activity.getWindow().setStatusBarColor(calculateStatusColor(color, statusBarAlpha));
        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            //透明狀態(tài)欄，contentView與狀態(tài)欄重疊，需使用fitSystemWindow屬性
            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);
        }
    }

/**
     * 生成一個(gè)和狀態(tài)欄大小相同的半透明矩形條
     *
     * @param activity 需要設(shè)置的activity
     * @param color    狀態(tài)欄顏色值
     * @param alpha    透明值
     * @return 狀態(tài)欄矩形條
     */
    private static View createStatusBarView(Activity activity, @ColorInt int color, int alpha) {
        // 繪制一個(gè)和狀態(tài)欄一樣高的矩形
        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;
    }

布局延展至狀態(tài)欄

1、android 5.0及以上版本
使用setSystemUiVisibility方法，設(shè)置View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN和View.SYSTEM_UI_FLAG_LAYOUT_STABLE。

//代碼配置
activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
activity.getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION);
activity.getWindow().setStatusBarColor(Color.TRANSPARENT);
activity.getWindow().getDecorView().setSystemUiVisibility(
        View.SYSTEM_UI_FLAG_LAYOUT_STABLE
                | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
                | SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION

);

//xml配置：values-v21/styles.xml中主題增加以下內(nèi)容
<style name="fullScreenTheme" parent="Theme.AppCompat.Light.DarkActionBar">
    <item name="android:windowTranslucentStatus">false</item>
    <item name="android:windowTranslucentNavigation">true</item>
    <item name="android:statusBarColor">@android:color/transparent</item>
</style>

避免使用WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS屬性，以提高體驗(yàn)，解決6.0系統(tǒng)的兼容性問(wèn)題


6.0系統(tǒng)半透明狀態(tài)欄

2、android 4.4版本

window.addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);

上述的兩個(gè)步驟，針對(duì)下圖中圖片延展到狀態(tài)欄，能完全滿(mǎn)足需求。


圖片延展

但針對(duì)一些布局延展，則需要額外處理來(lái)解決布局內(nèi)容和狀態(tài)欄區(qū)域覆蓋的問(wèn)題。一般的做法是使用fitSystemWindow屬性

fitSystemWindow

可以通過(guò)java代碼或xml來(lái)配置。
1、view的fitsSystemWindows設(shè)置為true后，系統(tǒng)會(huì)調(diào)整view的padding來(lái)給statusbar留出空間，padding的值與statusbar的高度相同。如果該view設(shè)置了背景色，則狀態(tài)欄顯示與view一致的背景色。若view未設(shè)置背景色，則會(huì)顯示activity默認(rèn)的背景色（theme中指定）；如果activity移除了默認(rèn)背景色，則狀態(tài)欄會(huì)顯示黑色。
2、如果是activity中包含fragment，則需要在fragment的內(nèi)容中設(shè)置fitsSystemWindows屬性。
3、建議在xml中進(jìn)行靈活配置。如果通過(guò)theme或代碼直接設(shè)置第一個(gè)子view的fitSystemWindows屬性，容易出現(xiàn)問(wèn)題。
4、多個(gè)view設(shè)置該屬性時(shí)，一般只有第一個(gè)view生效。

默認(rèn)背景色

可通過(guò)在style中設(shè)置windowBackground屬性或java代碼設(shè)置activity的默認(rèn)背景色。系統(tǒng)提供的theme中，通過(guò)windowBackground設(shè)置了默認(rèn)背景色。

//xml中設(shè)置
<item name="android:windowBackground">@color/white</item>

//java代碼設(shè)置
getWindow().setBackgroundDrawable(drawable)

一般情況下，不推薦對(duì)activity設(shè)置默認(rèn)背景。因activity的布局中一般有自己的背景色，添加window的背景色容易造成overdraw降低性能。一般使用getWindow().setBackgroundDrawable(null)或者xml中設(shè)置android:windowbackground="null" 刪除window的背景色。但有以下注意事項(xiàng)。
1.這句代碼必須要在setContentView()方法之后調(diào)用。
否則在頁(yè)面未布局前，會(huì)出現(xiàn)一閃而過(guò)的黑影，影響用戶(hù)體驗(yàn)。

2.若activity的父布局未設(shè)置背景，會(huì)出現(xiàn)沒(méi)有子view的空白部分出現(xiàn)黑色。甚至在webview的使用時(shí)，出現(xiàn)滑動(dòng)顯示繪制異常的問(wèn)題。建議給布局設(shè)置一個(gè)背景。

狀態(tài)欄默認(rèn)顏色

通過(guò)在theme中設(shè)置colorPrimaryDark。注意，在android 5.0之后才能進(jìn)行該屬性設(shè)置

<item name="colorPrimaryDark">@android:color/black</item>

下圖可參考幾個(gè)關(guān)鍵color屬性的影響位置。


image.png

參考文檔：
Android透明狀態(tài)欄與沉浸模式全解
android 5.0系統(tǒng)新加的默認(rèn)顏色 colorPrimary,colorPrimaryDark的作用
由沉浸式狀態(tài)欄引發(fā)的血案
關(guān)于如何實(shí)現(xiàn)Android透明狀態(tài)欄的總結(jié)
Android沉浸式狀態(tài)欄(透明狀態(tài)欄)最佳實(shí)現(xiàn)

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書(shū)系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容