android 沉浸式狀態欄

 

 

博客原文：http://www.jcodecraeer.com/a/opensource/2017/0526/7976.html

github地址：https://github.com/gyf-dev/ImmersionBar

介紹：

android 4.4以上沉浸式狀態欄和沉浸式導航欄管理，一句代碼輕松實現，以及對bar的其他設置

運行效果：

使用說明：

相關文章：http://www.jianshu.com/p/2a884e211a62 

android studio

1. compile 'com.gyf.barlibrary:barlibrary:2.1.9'

eclipse

barlibrary-2.1.9.jar

下載demo

下載

初始化

基礎用法（已經可以滿足日常沉浸式）

1. ImmersionBar.with(this).init();

高級用法(每個參數的意義)

1.  ImmersionBar.with(this)
2.              .transparentStatusBar()  //透明狀態欄，不寫默認透明色
3.              .transparentNavigationBar()  //透明導航欄，不寫默認黑色(設置此方法，fullScreen()方法自動為true)
4.              .transparentBar()             //透明狀態欄和導航欄，不寫默認狀態欄為透明色，導航欄為黑色（設置此方法，fullScreen()方法自動為true）
5.              .statusBarColor(R.color.colorPrimary)     //狀態欄顏色，不寫默認透明色
6.              .navigationBarColor(R.color.colorPrimary) //導航欄顏色，不寫默認黑色
7.              .barColor(R.color.colorPrimary)  //同時自定義狀態欄和導航欄顏色，不寫默認狀態欄為透明色，導航欄為黑色
8.              .statusBarAlpha(0.3f)  //狀態欄透明度，不寫默認0.0f
9.              .navigationBarAlpha(0.4f)  //導航欄透明度，不寫默認0.0F
10.              .barAlpha(0.3f)  //狀態欄和導航欄透明度，不寫默認0.0f
11.              .statusBarDarkFont(true)   //狀態欄字體是深色，不寫默認為亮色
12.              .fullScreen(true)      //有導航欄的情況下，activity全屏顯示，也就是activity最下面被導航欄覆蓋，不寫默認非全屏
13.              .hideBar(BarHide.FLAG_HIDE_BAR)  //隱藏狀態欄或導航欄或兩者，不寫默認不隱藏
14.              .setViewSupportTransformColor(toolbar) //設置支持view變色，支持一個view，不指定顏色，默認和狀態欄同色，還有兩個重載方法
15.              .addViewSupportTransformColor(toolbar)  //設置支持view變色，可以添加多個view，不指定顏色，默認和狀態欄同色，還有兩個重載方法
16.              .statusBarView(view)  //解決狀態欄和布局重疊問題
17.              .fitsSystemWindows(false)    //解決狀態欄和布局重疊問題，默認為false，當為true時一定要指定statusBarColor()，不然狀態欄為透明色
18.              .statusBarColorTransform(R.color.orange)  //狀態欄變色后的顏色
19.              .navigationBarColorTransform(R.color.orange) //導航欄變色后的顏色
20.              .barColorTransform(R.color.orange)  //狀態欄和導航欄變色后的顏色
21.              .removeSupportView()  //移除通過setViewSupportTransformColor()方法指定的view
22.              .removeSupportView(toolbar)  //移除指定view支持
23.              .removeSupportAllView() //移除全部view支持
24.              .init();  //必須調用方可沉浸式

關閉銷毀

在activity的onDestroy方法中執行

1. ImmersionBar.with(this).destroy(); //不調用該方法，如果界面bar發生改變，在不關閉app的情況下，退出此界面再進入將記憶最后一次bar改變的狀態

建議

建議在BaseActivity中初始化和銷毀

1. public class BaseActivity extends AppCompatActivity {
2.      @Override
3.      protected void onCreate(@Nullable Bundle savedInstanceState) {
4.          super.onCreate(savedInstanceState);
5.          ImmersionBar.with(this).init();
6.      }
7.  
8.      @Override
9.      protected void onDestroy() {
10.          super.onDestroy();
11.          ImmersionBar.with(this).destroy();  //不調用該方法，如果界面bar發生改變，在不關閉app的情況下，退出此界面再進入將記憶最后一次bar改變的狀態
12.      }
13.  }

在Fragment中的用法（fragment+viewpager）

為了使每個fragment都可以設置不同的沉浸式樣式，這里給出兩種解決方式，這兩種實現效果都一樣的

①使用viewpager的addOnPageChangeListener方法，代碼如下

1.  viewPager.addOnPageChangeListener(new ViewPager.OnPageChangeListener() {
2.          @Override
3.          public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
4.  
5.          }
6.  
7.          @Override
8.          public void onPageSelected(int position) {
9.              ImmersionBar immersionBar = ImmersionBar.with(FragmentActivity.this);
10.              switch (position) {
11.                  case 0:
12.                      immersionBar.statusBarDarkFont(false)
13.                              .navigationBarColor(R.color.btn4)
14.                              .init();
15.                      break;
16.                  case 1:
17.                      immersionBar.statusBarDarkFont(true)
18.                              .navigationBarColor(R.color.btn3)
19.                              .init();
20.                      break;
21.                  case 2:
22.                      immersionBar.statusBarDarkFont(false)
23.                              .navigationBarColor(R.color.btn13)
24.                              .init();
25.                      break;
26.                  case 3:
27.                      immersionBar.statusBarDarkFont(true)
28.                              .navigationBarColor(R.color.btn1)
29.                              .init();
30.                      break;
31.              }
32.          }
33.  
34.          @Override
35.          public void onPageScrollStateChanged(int state) {
36.  
37.          }
38.      });

②繼承ImmersionFragment類，在immersionInit中初始化沉浸式，代碼如下：

1. public class OneFragment extends ImmersionFragment {
2.      @Nullable
3.      @Override
4.         public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
5.             return inflater.inflate(R.layout.fragment_one, container, false);
6.         }
7.         @Override
8.         protected void immersionInit() {
9.             ImmersionBar.with(getActivity())
10.                     .statusBarDarkFont(false)
11.                     .navigationBarColor(R.color.btn4)
12.                     .init();
13.         }
14.     }

狀態欄與布局頂部重疊解決方案，四種方案任選其一

① 使用dimen自定義狀態欄高度

在values-v19/dimens.xml文件下

1.     <dimen name="status_bar_height">25dp</dimen>

在values/dimens.xml文件下

1.  <dimen name="status_bar_height">0dp</dimen>

然后在布局界面添加view標簽，高度指定為status_bar_height

1.    <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
2.        xmlns:app="http://schemas.android.com/apk/res-auto"
3.        android:layout_width="match_parent"
4.        android:layout_height="match_parent"
5.        android:background="@color/darker_gray"
6.        android:orientation="vertical">
7.    
8.        <View
9.            android:layout_width="match_parent"
10.            android:layout_height="@dimen/status_bar_height"
11.            android:background="@color/colorPrimary" />
12.    
13.        <android.support.v7.widget.Toolbar
14.            android:layout_width="match_parent"
15.            android:layout_height="wrap_content"
16.            android:background="@color/colorPrimary"
17.            app:title="方法一"
18.            app:titleTextColor="@android:color/white" />
19.    </LinearLayout>

② 使用系統的fitsSystemWindows屬性

1.     <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
2.         android:layout_width="match_parent"
3.         android:layout_height="match_parent"
4.         android:orientation="vertical"
5.         android:fitsSystemWindows="true">
6.     </LinearLayout>

然后使用ImmersionBar時候必須指定狀態欄顏色

③ 使用ImmersionBar的fitsSystemWindows(boolean fits)方法

1.     ImmersionBar.with(this)
2.         .statusBarColor(R.color.colorPrimary)
3.         .fitsSystemWindows(true)  //使用該屬性必須指定狀態欄的顏色，不然狀態欄透明，很難看
4.         .init();

④ 使用ImmersionBar的statusBarView(View view)方法

在標題欄的上方增加View標簽，高度指定為0dp

1.     <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
2.            xmlns:app="http://schemas.android.com/apk/res-auto"
3.            android:layout_width="match_parent"
4.            android:layout_height="match_parent"
5.            android:background="@color/darker_gray"
6.            android:orientation="vertical">
7.        
8.            <View
9.                android:layout_width="match_parent"
10.                android:layout_height="0dp"
11.                android:background="@color/colorPrimary" />
12.        
13.            <android.support.v7.widget.Toolbar
14.                android:layout_width="match_parent"
15.                android:layout_height="wrap_content"
16.                android:background="@color/colorPrimary"
17.                app:title="方法四"
18.                app:titleTextColor="@android:color/white" />
19.     </LinearLayout>

然后使用ImmersionBar的statusBarView方法，指定view就可以啦

1.      ImmersionBar.with(this)
2.            .statusBarView(view)
3.            .init();

解決EditText和軟鍵盤的問題

1.       KeyboardPatch.patch(this, linearLayout).enable(); //解決底部EditText和軟鍵盤的問題，linearLayout指的是當前布局的根節點

當白色背景狀態欄遇到不能改變狀態欄字體為深色的設備時，解決方案

1.       if(ImmersionBar.isSupportStatusBarDarkFont()){ //判斷當前設備支不支持狀態欄字體變色
2.           //處理狀態欄字體為黑色
3.       }else {
4.           //處理狀態欄有透明度
5.       }

狀態欄和導航欄其它方法

• public static boolean hasNavigationBar(Activity activity)

  判斷是否存在導航欄

• public static int getNavigationBarHeight(Activity activity)

  獲得導航欄的高度

• public static int getNavigationBarWidth(Activity activity)

  獲得導航欄的寬度

• public static boolean isNavigationAtBottom(Activity activity)

  判斷導航欄是否在底部

• public static int getStatusBarHeight(Activity activity)

  或得狀態欄的高度

• public static int getActionBarHeight(Activity activity)

  或得ActionBar得高度