『Android开源控件』ImmersionBar沉浸式状态栏

6,098 阅读4分钟

本文已参与「新人创作礼」活动,一起开启掘金创作之路。

👨‍🎓作者简介:一位喜欢写作,计科专业的大二菜鸟

🏡个人主页:starry陆离

🕒首发日期:2022年6月24日星期五

🌌上期文章:『Android基础入门』SharedPreferences简单数据存储【模拟QQ登录】

📚订阅专栏:『Android基础入门』 如果文章有帮到你的话记得点赞👍+收藏💗支持一下哦


注意:不是教程只是笔记,如有错误欢迎批评指正

🌾官方简介

gyf-dev/ImmersionBar: android 4.4以上沉浸式状态栏和沉浸式导航栏管理

ImmersionBar: android 4.4以上沉浸式状态栏和沉浸式导航栏管理

android 4.4以上沉浸式状态栏和沉浸式导航栏管理,适配横竖屏切换、刘海屏、软键盘弹出等问题,可以修改状态栏字体颜色和导航栏图标颜色,以及不可修改字体颜色手机的适配,适用于Activity、Fragment、DialogFragment、Dialog,PopupWindow,一句代码轻松实现,以及对bar的其他设置

🌼添加依赖

 // 基础依赖包,必须要依赖
 implementation 'com.geyifeng.immersionbar:immersionbar:3.2.2'
 // kotlin扩展(可选)
 implementation 'com.geyifeng.immersionbar:immersionbar-ktx:3.2.2'
 // fragment快速实现(可选)已废弃
 implementation 'com.geyifeng.immersionbar:immersionbar-components:3.2.2'

image-20220427224941845

🍁修改themes.xml

Snipaste_2022-04-27_23-01-24

在themes.xml文件下修改NoActionBar

image-20220427225824728

MainActivity中使用ImmersionBar

 //todo
 ImmersionBar.with(this)
     .init();

image-20220427230453667

🌳效果演示

image-20220427230607593

🌺Api详解

基础用法

 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)   //状态栏字体是深色,不写默认为亮色
      .navigationBarDarkIcon(true) //导航栏图标是深色,不写默认为亮色
      .autoDarkModeEnable(true) //自动状态栏字体和导航栏图标变色,必须指定状态栏颜色和导航栏颜色才可以自动变色哦
      .autoStatusBarDarkModeEnable(true,0.2f) //自动状态栏字体变色,必须指定状态栏颜色才可以自动变色哦
      .autoNavigationBarDarkModeEnable(true,0.2f) //自动导航栏图标变色,必须指定导航栏颜色才可以自动变色哦
      .flymeOSStatusBarFontColor(R.color.btn3)  //修改flyme OS状态栏字体颜色
      .fullScreen(true)      //有导航栏的情况下,activity全屏显示,也就是activity最下面被导航栏覆盖,不写默认非全屏
      .hideBar(BarHide.FLAG_HIDE_BAR)  //隐藏状态栏或导航栏或两者,不写默认不隐藏
      .addViewSupportTransformColor(toolbar)  //设置支持view变色,可以添加多个view,不指定颜色,默认和状态栏同色,还有两个重载方法
      .titleBar(view)    //解决状态栏和布局重叠问题,任选其一
      .titleBarMarginTop(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支持
      .navigationBarEnable(true)   //是否可以修改导航栏颜色,默认为true
      .navigationBarWithKitkatEnable(true)  //是否可以修改安卓4.4和emui3.x手机导航栏颜色,默认为true
      .navigationBarWithEMUI3Enable(true) //是否可以修改emui3.x手机导航栏颜色,默认为true
      .keyboardEnable(true)  //解决软键盘与底部输入框冲突问题,默认为false,还有一个重载方法,可以指定软键盘mode
      .keyboardMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE)  //单独指定软键盘模式
      .setOnKeyboardListener(new OnKeyboardListener() {    //软键盘监听回调,keyboardEnable为true才会回调此方法
          @Override
          public void onKeyboardChange(boolean isPopup, int keyboardHeight) {
              LogUtils.e(isPopup);  //isPopup为true,软键盘弹出,为false,软键盘关闭
          }
      })
      .setOnNavigationBarListener(onNavigationBarListener) //导航栏显示隐藏监听,目前只支持华为和小米手机
      .setOnBarListener(OnBarListener) //第一次调用和横竖屏切换都会触发,可以用来做刘海屏遮挡布局控件的问题
      .addTag("tag")  //给以上设置的参数打标记
      .getTag("tag")  //根据tag获得沉浸式参数
      .reset()  //重置所以沉浸式参数
      .init();  //必须调用方可应用以上所配置的参数

在Activity中实现沉浸式

java

  ImmersionBar.with(this).init();

🍀卡片控件MaterialCardView

MaterialCardView | Android Developers (google.cn)

在activity_main.xml中,我们可以通过关键词直接添加MaterialCardView控件

image-20220428194639989

在使用MaterialCardView控件时,我们并不是直接在其中添加基本控件,而是先嵌套一层布局,再在布局中添加控件,如下代码:

 <?xml version="1.0" encoding="utf-8"?>
 <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:app="http://schemas.android.com/apk/res-auto"
     xmlns:tools="http://schemas.android.com/tools"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     tools:context=".MainActivity">
 ​
     <com.google.android.material.card.MaterialCardView
         android:layout_width="180dp"
         android:layout_height="220dp"
         android:layout_marginTop="96dp"
         app:layout_constraintHorizontal_bias="0.497"
         app:layout_constraintLeft_toLeftOf="parent"
         app:layout_constraintRight_toRightOf="parent"
         app:layout_constraintTop_toTopOf="parent"
 ​
         app:cardElevation="20dp"
         app:cardBackgroundColor="#18A598"
         app:contentPadding="5dp"
         app:cardCornerRadius="10dp"
         app:cardMaxElevation="100dp"
         android:clickable="true"
         android:focusable="true"
         app:rippleColor="#9FD3A2">
 ​
         <androidx.constraintlayout.widget.ConstraintLayout
             android:layout_width="match_parent"
             android:layout_height="match_parent">
 ​
 ​
             <ImageView
                 android:id="@+id/imageView"
                 android:layout_width="180dp"
                 android:layout_height="180dp"
                 app:layout_constraintBottom_toBottomOf="parent"
                 app:layout_constraintEnd_toEndOf="parent"
                 app:layout_constraintHorizontal_bias="0.0"
                 app:layout_constraintStart_toStartOf="parent"
                 app:layout_constraintTop_toTopOf="parent"
                 app:layout_constraintVertical_bias="0.0"
                 app:srcCompat="@drawable/wendi" />
 ​
             <TextView
                 android:id="@+id/textView"
                 android:layout_width="match_parent"
                 android:layout_height="40dp"
                 android:text="温迪"
                 android:textAlignment="center"
                 android:textColor="@color/black"
                 android:textSize="25sp"
                 app:layout_constraintEnd_toEndOf="parent"
                 app:layout_constraintTop_toBottomOf="@+id/imageView" />
         </androidx.constraintlayout.widget.ConstraintLayout>
     </com.google.android.material.card.MaterialCardView>
 ​
 </androidx.constraintlayout.widget.ConstraintLayout>

其中MaterialCardView有很多重要的属性如下:

  <com.google.android.material.card.MaterialCardView
         app:cardElevation="20dp"  设置z轴高度,来控制阴影的大小
         app:cardBackgroundColor="#18A598"   设置CardView背景色
         app:contentPadding="5dp"    设置内边距
         app:cardCornerRadius="10dp" 设置CardView的圆角半径
         app:cardMaxElevation="100dp"    设置最大z轴高度
         android:clickable="true"      是否可点击
         android:focusable="true"    是否获取焦点
         app:rippleColor="#9FD3A2"   点击阴影特效的颜色>   
 </com.google.android.material.card.MaterialCardView>