android沉浸式狀態(tài)欄 輕量 簡(jiǎn)便

android沉浸式狀態(tài)欄 android 沉浸式狀態(tài)欄


網(wǎng)上看了很多沉浸式,感覺(jué)用起來(lái)麻煩,而且有些庫(kù)非常大,于是自己寫了個(gè)簡(jiǎn)單輕量的、高度自定義的并且可以適配4.4以上99%機(jī)型的工具。

注:狀態(tài)欄字體顏色需要6.0以上才有效果,6.0以下默認(rèn)白色。于是我加了個(gè)兼容的方法setUseStatusBarColor(Activity activity, @ColorInt int color, int surfaceColor),解決了頭部全白的問(wèn)題。

主要提供了三個(gè)方法:

// 第二個(gè)參數(shù)是狀態(tài)欄色值。
// 第三個(gè)參數(shù)是兼容5.0到6.0之間的狀態(tài)欄顏色字體只能是白色,如果沉浸的顏色與狀態(tài)欄顏色沖突, 設(shè)置一層淺色對(duì)比能顯示出狀態(tài)欄字體(可以找ui給一個(gè)合適顏色值)。
// 如果您的項(xiàng)目是6.0以上機(jī)型或者某些界面不適用沉浸, 推薦使用兩個(gè)參數(shù)的setUseStatusBarColor。
StatusUtil.setUseStatusBarColor(this, Color.TRANSPARENT, Color.parseColor("#33000000"));

// 第二個(gè)參數(shù)是是否沉浸,第三個(gè)參數(shù)是狀態(tài)欄字體是否為黑色。
setSystemStatus(Activity activity, boolean isTransparent, boolean isBlack);

// 該類是經(jīng)過(guò)本人修改的,需要到請(qǐng)使用statuslib里面的。
AndroidBug5497Workaround.assistActivity(this);
 如果用到,請(qǐng)?jiān)谇鍐挝募揳ctivity也加上:android:windowSoftInputMode="adjustResize"

廢話不多說(shuō),開(kāi)始介紹使用方法。

引入項(xiàng)目

1.工程的gradle

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

2.module的gradle

dependencies {
       compile 'com.github.crossoverone:StatusBarUtil:1.3.4'//會(huì)不定時(shí)更新,請(qǐng)及時(shí)更新
}

使用(細(xì)節(jié)請(qǐng)參照demo)

一、activity中簡(jiǎn)單使用

public  class  MainActivity extends AppCompatActivity {
    ...
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ...
        setContentView(R.layout.activity_main);

        // 第二個(gè)參數(shù)是狀態(tài)欄色值。
        // 第三個(gè)參數(shù)是兼容5.0到6.0之間的狀態(tài)欄顏色字體只能是白色,如果沉浸的顏色與狀態(tài)欄顏色沖突, 設(shè)置一層淺色對(duì)比能顯示出狀態(tài)欄字體(可以找ui給一個(gè)合適顏色值)。
        // 如果您的項(xiàng)目是6.0以上機(jī)型或者某些界面不適用沉浸, 推薦使用兩個(gè)參數(shù)的setUseStatusBarColor。
        StatusUtil.setUseStatusBarColor(this, Color.TRANSPARENT, Color.parseColor("#33000000"));

        // 第二個(gè)參數(shù)是是否沉浸,第三個(gè)參數(shù)是狀態(tài)欄字體是否為黑色。
        StatusUtil.setSystemStatus(this, false, true);
        ...
    }
    ...
}

二、BaseActivity(基類)中使用

public abstract class  BaseActivity extends AppCompatActivity {
    ...
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ...
        setContentView(getLayoutRes());

        //基類設(shè)置默認(rèn)值,這里是非沉浸,狀態(tài)欄顏色值#878787,字體顏色為黑色。
        setStatusColor();
        setSystemInvadeBlack();
        ...
    }
    ...
    protected void setStatusColor() {
        StatusUtil.setUseStatusBarColor(this, Color.parseColor("#878787"));
    }
    ...
    protected void setSystemInvadeBlack() {
        // 第二個(gè)參數(shù)是是否沉浸,第三個(gè)參數(shù)是狀態(tài)欄字體是否為黑色。
        StatusUtil.setSystemStatus(this, false, true);
    }
    ...
}

子類需要修改則分別重寫該方法(假設(shè)需要換個(gè)狀態(tài)欄顏色 & 設(shè)置沉侵式 & 字體為白色)。

public class MainActivity extends BaseActivity {
    ...
    @Override
    protected void setStatusColor() {
        StatusUtil.setUseStatusBarColor(this, Color.parseColor("#252525"));
    }
    ...
    @Override
    protected void setSystemInvadeBlack() {
        // 第二個(gè)參數(shù)是是否沉浸,第三個(gè)參數(shù)是狀態(tài)欄字體是否為黑色。
        StatusUtil.setSystemStatus(this, true, false);
    }
    ...
}

三、設(shè)置沉侵的activity布局預(yù)留狀態(tài)欄高度兩種方法(選其中一種即可)

1.xml中設(shè)置,靈活性也不是很高,但實(shí)現(xiàn)簡(jiǎn)單(題外話:約束布局確實(shí)不錯(cuò),推薦大家使用)

加上一句:android:fitsSystemWindows="true" 。

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="true"
    xmlns:app="http://schemas.android.com/apk/res-auto">

    .........

</android.support.constraint.ConstraintLayout>

2.activity中設(shè)置,靈活度高,寫的代碼就比較多

@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    setContentView(getLayoutRes());

    // 第二個(gè)參數(shù)是狀態(tài)欄色值。
    // 第三個(gè)參數(shù)是兼容5.0到6.0之間的狀態(tài)欄顏色字體只能是白色,如果沉浸的顏色與狀態(tài)欄顏色沖突, 設(shè)置一層淺色對(duì)比能顯示出狀態(tài)欄字體(可以找ui給一個(gè)合適顏色值)。
    // 如果您的項(xiàng)目是6.0以上機(jī)型或者某些界面不適用沉浸, 推薦使用兩個(gè)參數(shù)的setUseStatusBarColor。
    StatusUtil.setUseStatusBarColor(this, Color.TRANSPARENT, Color.parseColor("#33000000"));

    StatusUtil.setSystemStatus(this, true, true);
    initTitle();
    ...
}

private void initTitle(){
    if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT){
        xxxxxx.LayoutParams layoutParams = new xxxxxx.LayoutParams(xxxxxx.LayoutParams.MATCH_PARENT, xxxxxx.LayoutParams.MATCH_PARENT);
        layoutParams.setMargins(0, StatusUtil.getStatusBarHeight(this.getActivity()), 0, 0);
        //頂部距離
        titleView.setLayoutParams(layoutParams);    
    }
}

四、界面是ViewPager+fragment聯(lián)合使用

1.使用方式

設(shè)置監(jiān)聽(tīng),可以根據(jù)需求設(shè)置狀態(tài)欄字體顏色為黑色或白色:

mViewPager.addOnPageChangeListener(new ViewPager.OnPageChangeListener() {
        ...
        @Override
        public void onPageSelected(int position) {
            switch (position) {
                case 0:
                    isBlack = false;
                    StatusUtil.setSystemStatus(MainActivity.this, true, isBlack);
                    break;
                case 1:
                    isBlack = true;
                    StatusUtil.setSystemStatus(MainActivity.this, true, isBlack);
                    break;
                case 2:
                    isBlack = false;
                    StatusUtil.setSystemStatus(MainActivity.this, true, isBlack);
                    break;
            }
        }
        ...
    });

2.注意事項(xiàng)

fragmentA 需要沉浸,fragmentB不需要沉浸使用時(shí),要固定第二個(gè)參數(shù)為true,否則布局會(huì)上下移動(dòng):

activity中:

public class MainActivity extends BaseActivity {
   ...
    @Override
    protected void setSystemInvadeBlack() {
        // 第二個(gè)參數(shù)保持不變,第三個(gè)參數(shù)是狀態(tài)欄字體是否為黑色
        StatusUtil.setSystemStatus(this, true, true);
    }
   ...
}
不需要沉浸的fragment幾種設(shè)置方法(選其中一種即可):

(1).xml可以設(shè)置layout_marginTop=“25dp”:(屬于偏方,雖然可以快速實(shí)現(xiàn),但不是完美的解決方式)

<?xml version="1.0" encoding="utf-8"?>
<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/color_f8f8f8"
    android:orientation="vertical">

    <FrameLayout
        android:id="@+id/titleView"
        android:layout_width="match_parent"
        android:layout_height="45dp"
        android:layout_marginTop="25dp"
        android:background="@color/color_f8f8f8">

        <TextView
            android:id="@+id/tv_title"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center"
            android:gravity="center"
            android:text="@string/main_title"
            android:textSize="16sp"/>

    </FrameLayout>
</LinearLayout>

(2).在fragment初始化view的時(shí)候(靈活度比較高,但是寫起來(lái)比較繁瑣):

@Nullable
@Override
public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, Bundle savedInstanceState) {
    ···
    mInflateview =···;
    ···
    if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT){
            xxxxxx.LayoutParams layoutParams = new  xxxxxx.LayoutParams(xxxxxx.LayoutParams.MATCH_PARENT, xxxxxx.LayoutParams.MATCH_PARENT);
            layoutParams.setMargins(0, StatusUtil.getStatusBarHeight(this.getActivity()), 0, 0);
            //頂部距離
            titleView.setLayoutParams(layoutParams);
    }
    return mInflateview;

}

(3).在fragment初始化view的時(shí)候(實(shí)現(xiàn)簡(jiǎn)單,但有一定的局限性):

@Nullable
@Override
public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, Bundle savedInstanceState) {
    ···
    mInflateview =···;
    ··· 
    if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT){
        mInflateview .setPadding(0, StatusUtil.getStatusBarHeight(mContext), 0, 0);
    }
    ···
    return mInflateview;

}

五、類似聊天窗口(底部有輸入框)使用方式

先上代碼,再說(shuō)明,分兩步:

1.AndroidManifest.xml的指定activity加上一行。例如:
<activity 
    android:name="crossoverone.activity.FirstActivity"
    android:windowSoftInputMode="adjustResize"http://加上這一行
/>
2.在activity的setContentView之后,使用statusUtil之前。例如:
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_first);

    AndroidBug5497Workaround.assistActivity(this);//加上這一行

    // 第二個(gè)參數(shù)是狀態(tài)欄色值。
    // 第三個(gè)參數(shù)是兼容5.0到6.0之間的狀態(tài)欄顏色字體只能是白色,如果沉浸的顏色與狀態(tài)欄顏色沖突, 設(shè)置一層淺色對(duì)比能顯示出狀態(tài)欄字體(可以找ui給一個(gè)合適顏色值)。
    // 如果您的項(xiàng)目是6.0以上機(jī)型或者某些界面不適用沉浸, 推薦使用兩個(gè)參數(shù)的setUseStatusBarColor。
    StatusUtil.setUseStatusBarColor(this, Color.TRANSPARENT, Color.parseColor("#33000000"));
    StatusUtil.setSystemStatus(this, true, true);
   
}   

如果在baseActivity 已經(jīng)封裝過(guò)了,在子類中重寫setStatusColor方法。

protected void setStatusColor() {
    AndroidBug5497Workaround.assistActivity(this);//加上這一行,一定要在第一行
    StatusUtil.setUseStatusBarColor(this, Color.parseColor("#878787"));
}

注:當(dāng)前界面的固定顯示內(nèi)容要小于等于彈出軟鍵盤之后的布局高度,否則軟鍵盤彈出后將遮蓋部分布局。

github地址

https://github.com/crossoverone/StatusBarUtil

結(jié)語(yǔ)

如果覺(jué)得好用,請(qǐng)您繼續(xù)關(guān)注,后續(xù)我將持續(xù)更新內(nèi)容,為大家開(kāi)發(fā)提供便捷的工具。如果覺(jué)得不好用,請(qǐng)給出您寶貴的意見(jiàn),我將根據(jù)您的意見(jiàn)進(jìn)行修改。謝謝您的關(guān)注!!!

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。