輕量簡便的android沉浸式狀態列

crossover發表於2018-02-03
Android

網上看了很多沉浸式，感覺用起來麻煩，而且有些庫非常大，於是自己寫了個簡單輕量的、高度自定義的並且可以適配4.4以上99%機型的工具。

注：狀態列字型顏色需要6.0以上才有效果，6.0以下預設白色。於是我加了個相容的方法setUseStatusBarColor（Activity activity, @ColorInt int color, int surfaceColor），解決了頭部全白的問題。

主要提供了三個方法：

// 第二個引數是狀態列色值。
// 第三個引數是相容5.0到6.0之間的狀態列顏色字型只能是白色，如果沉浸的顏色與狀態列顏色衝突, 設定一層淺色對比能顯示出狀態列字型（可以找ui給一個合適顏色值）。
// 如果您的專案是6.0以上機型或者某些介面不適用沉浸, 推薦使用兩個引數的setUseStatusBarColor。
StatusUtil.setUseStatusBarColor(this, Color.TRANSPARENT, Color.parseColor("#33000000"));

// 第二個引數是是否沉浸,第三個引數是狀態列字型是否為黑色。
setSystemStatus（Activity activity, boolean isTransparent, boolean isBlack）;

// 該類是經過本人修改的,需要到請使用statuslib裡面的。
AndroidBug5497Workaround.assistActivity(this);
 如果用到，請在清單檔案該activity也加上：android:windowSoftInputMode="adjustResize"
複製程式碼

廢話不多說，開始介紹使用方法。

引入專案

1.工程的gradle

allprojects {
	repositories {
		...
		maven { url 'https://jitpack.io' }
	}
}
複製程式碼

2.module的gradle

dependencies {
       compile 'com.github.crossoverone:StatusBarUtil:1.3.3'//會不定時更新，請及時更新
}
複製程式碼

使用(細節請參照demo)

一、activity中簡單使用

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

		// 第二個引數是狀態列色值。
		// 第三個引數是相容5.0到6.0之間的狀態列顏色字型只能是白色，如果沉浸的顏色與狀態列顏色衝突, 設定一層淺色對比能顯示出狀態列字型（可以找ui給一個合適顏色值）。
		// 如果您的專案是6.0以上機型或者某些介面不適用沉浸, 推薦使用兩個引數的setUseStatusBarColor。
		StatusUtil.setUseStatusBarColor(this, Color.TRANSPARENT, Color.parseColor("#33000000"));

		// 第二個引數是是否沉浸,第三個引數是狀態列字型是否為黑色。
		StatusUtil.setSystemStatus(this, false, true);
		...
    }
	...
}
複製程式碼

二、BaseActivity(基類)中使用

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

		//基類設定預設值,這裡是非沉浸,狀態列顏色值#878787,字型顏色為黑色。
		setStatusColor();
		setSystemInvadeBlack();
		...
    }
	...
	protected void setStatusColor() {
		StatusUtil.setUseStatusBarColor(this, Color.parseColor("#878787"));
    }
	...
	protected void setSystemInvadeBlack() {
		// 第二個引數是是否沉浸,第三個引數是狀態列字型是否為黑色。
		StatusUtil.setSystemStatus(this, false, true);
    }
	...
}
複製程式碼

子類需要修改則分別重寫該方法(假設需要換個狀態列顏色 & 設定沉侵式 & 字型為白色)。

public class MainActivity extends BaseActivity {
	...
	@Override
	protected void setStatusColor() {
		StatusUtil.setUseStatusBarColor(this, Color.parseColor("#252525"));
    }
	...
	@Override
	protected void setSystemInvadeBlack() {
		// 第二個引數是是否沉浸,第三個引數是狀態列字型是否為黑色。
		StatusUtil.setSystemStatus(this, true, false);
    }
	...
}
複製程式碼

三、設定沉侵的activity佈局預留狀態列高度兩種方法

1.xml中設定

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

<?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:layout_width="match_parent"
        android:layout_height="75dp"
        android:fitsSystemWindows="true"
        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.activity中設定

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

	// 第二個引數是狀態列色值。
	// 第三個引數是相容5.0到6.0之間的狀態列顏色字型只能是白色，如果沉浸的顏色與狀態列顏色衝突, 設定一層淺色對比能顯示出狀態列字型（可以找ui給一個合適顏色值）。
	// 如果您的專案是6.0以上機型或者某些介面不適用沉浸, 推薦使用兩個引數的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){
		LinearLayoutCompat.LayoutParams layoutParams = new LinearLayoutCompat.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
        layoutParams.setMargins(0, StatusUtil.getStatusBarHeight(this.getActivity()), 0, 0);
		//頂部距離
        titleView.setLayoutParams(layoutParams);	
	}
}
複製程式碼

四、介面是ViewPager+fragment聯合使用

1.使用方式

設定監聽,可以根據需求設定狀態列字型顏色為黑色或白色:

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.注意事項

fragmentA 需要沉浸，fragmentB不需要沉浸使用時，要固定第二個引數為true，否則佈局會上下移動：

activity中：

public class MainActivity extends BaseActivity {
   ...
    @Override
    protected void setSystemInvadeBlack() {
        // 第二個引數保持不變,第三個引數是狀態列字型是否為黑色
        StatusUtil.setSystemStatus(this, true, true);
    }
   ...
}
複製程式碼
不需要沉浸的fragment兩種設定方法:

（1）.xml可以設定layout_marginTop=“25dp”：

<?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: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的時候：

@Nullable
@Override
public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, Bundle savedInstanceState) {
    ···
    mInflateview =···;
	···
			
	LinearLayoutCompat.LayoutParams layoutParams = new LinearLayoutCompat.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
    layoutParams.setMargins(0, StatusUtil.getStatusBarHeight(this.getActivity()), 0, 0);
	//頂部距離
    titleView.setLayoutParams(layoutParams);
	
    return mInflateview;

}
複製程式碼

五、類似聊天視窗（底部有輸入框）使用方式

先上程式碼，再說明，分兩步：

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

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

	// 第二個引數是狀態列色值。
	// 第三個引數是相容5.0到6.0之間的狀態列顏色字型只能是白色，如果沉浸的顏色與狀態列顏色衝突, 設定一層淺色對比能顯示出狀態列字型（可以找ui給一個合適顏色值）。
	// 如果您的專案是6.0以上機型或者某些介面不適用沉浸, 推薦使用兩個引數的setUseStatusBarColor。
	StatusUtil.setUseStatusBarColor(this, Color.TRANSPARENT, Color.parseColor("#33000000"));
	StatusUtil.setSystemStatus(this, true, true);
   
}	
複製程式碼

如果在baseActivity 已經封裝過了,在子類中重寫setStatusColor方法。

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

注：當前介面的固定顯示內容要小於等於彈出軟鍵盤之後的佈局高度，否則軟鍵盤彈出後將遮蓋部分佈局。

github地址

https://github.com/crossoverone/StatusBarUtil
複製程式碼

結語

如果覺得好用，請您繼續關注，後續我將持續更新內容，為大家開發提供便捷的工具。如果覺得不好用，請給出您寶貴的意見，我將根據您的意見進行修改。謝謝您的關注！！！

相關文章