android沉浸式状态栏 轻量 简便

android沉浸式状态栏 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.4'//会不定时更新，请及时更新
}

使用(细节请参照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"?>
<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中设置，灵活度高，写的代码就比较多

@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){
        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联合使用

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: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的时候（灵活度比较高，但是写起来比较繁琐）：

@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的时候（实现简单，但有一定的局限性）：

@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;

}

五、类似聊天窗口（底部有输入框）使用方式

先上代码，再说明，分两步：

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

结语

如果觉得好用，请您继续关注，后续我将持续更新内容，为大家开发提供便捷的工具。如果觉得不好用，请给出您宝贵的意见，我将根据您的意见进行修改。谢谢您的关注！！！

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 203,324评论 5赞 476
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 85,303评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 150,192评论 0赞 337
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,555评论 1赞 273
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,569评论 5赞 365
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,566评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 37,927评论 3赞 395
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,583评论 0赞 257
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,827评论 1赞 297
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2赞 320
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1赞 329
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,365评论 4赞 318
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 38,941评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1赞 259
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2赞 349
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2赞 342