ImmersionBar

项目地址:gyf-dev/ImmersionBar
简介:android 4.4 以上沉浸式状态栏和沉浸式导航栏管理,一句代码轻松实现,以及对 bar 的其他设置,详见 README,http://www.jianshu.com/p/2a884e211a62
更多:作者   提 Bug   
标签:

直接看效果图,最下面有各个版本的效果图

使用

android studio

   compile 'com.gyf.barlibrary:barlibrary:2.2.4'

eclipse

barlibrary-2.2.4.jar

版本说明

点我

下载 demo

下载

用法

初始化

  • 基础用法(已经可以满足日常沉浸式)

      ImmersionBar.with(this).init();
    
  • 高级用法(每个参数的意义)

       ImmersionBar.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)   //状态栏字体是深色,不写默认为亮色
                   .flymeOSStatusBarFontColor(R.color.btn3)  //修改 flyme OS 状态栏字体颜色
                   .fullScreen(true)      //有导航栏的情况下,activity 全屏显示,也就是 activity 最下面被导航栏覆盖,不写默认非全屏
                   .hideBar(BarHide.FLAG_HIDE_BAR)  //隐藏状态栏或导航栏或两者,不写默认不隐藏
                   .addViewSupportTransformColor(toolbar)  //设置支持 view 变色,可以添加多个 view,不指定颜色,默认和状态栏同色,还有两个重载方法
                   .titleBar(view)    //解决状态栏和布局重叠问题,任选其一
                   .statusBarView(view)  //解决状态栏和布局重叠问题,任选其一
                   .fitsSystemWindows(true)    //解决状态栏和布局重叠问题,任选其一,默认为 false,当为 true 时一定要指定 statusBarColor(),不然状态栏为透明色
                   .supportActionBar(true) //支持 ActionBar 使用
                   .statusBarColorTransform(R.color.orange)  //状态栏变色后的颜色
                   .navigationBarColorTransform(R.color.orange) //导航栏变色后的颜色
                   .barColorTransform(R.color.orange)  //状态栏和导航栏变色后的颜色
                   .removeSupportView(toolbar)  //移除指定 view 支持
                   .removeSupportAllView() //移除全部 view 支持
                   .addTag("tag")  //给以上设置的参数打标记
                   .getTag("tag")  //根据 tag 获得沉浸式参数
                   .reset()  //重置所以沉浸式参数
                   .keyboardEnable(true)  //解决软键盘与底部输入框冲突问题,默认为 false
                   .init();  //必须调用方可沉浸式
    

关闭销毁

  • 在 activity 的 onDestroy 方法中执行

      ImmersionBar.with(this).destroy(); //不调用该方法,如果界面 bar 发生改变,在不关闭 app 的情况下,退出此界面再进入将记忆最后一次 bar 改变的状态
    

建议

  • 建议在 BaseActivity 中初始化和销毁

      public class BaseActivity extends AppCompatActivity {
           @Override
           protected void onCreate(@Nullable Bundle savedInstanceState) {
               super.onCreate(savedInstanceState);
               ImmersionBar.with(this).init();   //所有子类都将继承这些相同的属性
           }
    
           @Override
           protected void onDestroy() {
               super.onDestroy();
               ImmersionBar.with(this).destroy();  //不调用该方法,如果界面 bar 发生改变,在不关闭 app 的情况下,退出此界面再进入将记忆最后一次 bar 改变的状态
           }
       }
    

在 Fragment 中的用法(fragment+viewpager)

为了使每个 fragment 都可以设置不同的沉浸式样式,这里给出两种解决方式,这两种实现效果都一样的

  • ①使用 viewpager 的 addOnPageChangeListener 方法,代码如下

     viewPager.addOnPageChangeListener(new ViewPager.OnPageChangeListener() {
             @Override
             public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
                 switch (position) {
                     case 0:
                         ImmersionBar.with(oneFragment)
                                 .navigationBarColor(R.color.btn4)
                                 .init();
                         break;
                     case 1:
                         ImmersionBar.with(twoFragment)
                                 .statusBarDarkFont(true)
                                 .navigationBarColor(R.color.btn3)
                                 .init();
                         break;
                     case 2:
                         ImmersionBar.with(threeFragment)
                                 .navigationBarColor(R.color.btn13)
                                 .init();
                         break;
                     case 3:
                         ImmersionBar.with(fourFragment)
                                 .statusBarDarkFont(true)
                                 .navigationBarColor(R.color.btn1)
                                 .init();
                         break;
                 }
             }
    
             @Override
             public void onPageSelected(int position) {
    
             }
    
             @Override
             public void onPageScrollStateChanged(int state) {
    
             }
         });
    
  • ②继承 ImmersionFragment 类,在 immersionInit 中初始化沉浸式,调用该方法必须保证加载 Fragment 的 Activity 先初始化,代码如下:

     public class OneFragment extends ImmersionFragment {
          @Nullable
          @Override
             public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
                 return inflater.inflate(R.layout.fragment_one, container, false);
             }
             @Override
             protected void immersionInit() {
                 ImmersionBar.with(this) 
                         .statusBarDarkFont(false)
                         .navigationBarColor(R.color.btn4)
                         .init();
             }
         }
    
  • 如果想使当前 Fragment 不走 immersionInit()方法,请子类重写 immersionEnabled()方法,返回值设为 false
          @Override
          protected boolean immersionEnabled() {
              return false;
          }
    
  • 如果你的 Fragment 页面沉浸式都一样的话,你完全可以把它放在 activity 里的 onCreate 方法中初始化

状态栏与布局顶部重叠解决方案,五种方案任选其一

  • ① 使用 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 属性,要慎用,会有意想不到的坑,比如界面会发生错位

         <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 时候必须指定状态栏颜色

         ImmersionBar.with(this)
              .statusBarColor(R.color.colorPrimary)
              .init();
    
  • ③ 使用 ImmersionBar 的 fitsSystemWindows(boolean fits)方法

          ImmersionBar.with(this)
              .statusBarColor(R.color.colorPrimary)
              .fitsSystemWindows(true)  //使用该属性必须指定状态栏的颜色,不然状态栏透明,很难看
              .init();
    
  • ④ 使用 ImmersionBar 的 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>
    

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

           ImmersionBar.with(this)
                 .statusBarView(view)
                 .init();
    
  • ⑤ 使用 ImmersionBar 的 titleBar(View view)方法
               ImmersionBar.with(this)
                     .titleBar(view) //指定标题栏 view,xml 里的标题的高度不能指定为 warp_content
                     .init();
    

解决 EditText 和软键盘的问题

       ImmersionBar.with(this)
                   .keyboardEnable(true)  //解决软键盘与底部输入框冲突问题
                   .init();
       或者
       // KeyboardPatch.patch(this).enable();
       或者,layout 指的是当前布局的根节点
       // KeyboardPatch.patch(this, layout).enable();

当白色背景状态栏遇到不能改变状态栏字体为深色的设备时,解决方案

         ImmersionBar.with(this)
                     .statusBarDarkFont(true, 0.2f) //原理:如果当前设备支持状态栏字体变色,会设置状态栏字体为黑色,如果当前设备不支持状态栏字体变色,会使当前状态栏加上透明度,否则不执行透明度
                     .init();

状态栏和导航栏其它方法

  • 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 得高度

  • public static boolean isSupportStatusBarDarkFont()

    判断当前设备支不支持状态栏字体设置为黑色

效果图

说明

  • 这是状态栏 image
  • 这是导航栏(有些手机没有导航栏) image

    动态图

  • android 6.0 有导航栏效果

  • android 4.4 有导航栏效果

  • android 4.4 没有导航栏效果

特别鸣谢

联系我

  • QQ 群 314360549(沉浸式交流)
  • WeChat(微信)
Android 开发经验分享
用了一年多的理财推荐
Android 开发经验分享
用了一年多的理财推荐