状态栏着色原理和 API 版本兼容处理

1,195 阅读3分钟
原文链接: blog.csdn.net

介绍

先上实际效果图,有三个版本请注意区分API版本

API>=20 API=19 API<19
API20 API19 <19

以上的效果我们称之为对状态栏的着色,而非沉浸式状态栏,那是另外的东西。
想要实现以上的效果并不难,阅读本文了解原理后,就会觉得想要以上的效果真的很简单。
本文旨在总结我的理解告诉读者一步步实现状态栏着色的原理。

原理

第一步-设置透明状态栏

对状态栏的控制一切基础都源于

    static public void setTranslucentWindows(Activity activity) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            //透明状态栏
            activity.getWindow().addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
        }
    }

请注意该Flag标识的API版本为19,也就是只能在API>=19以上实现透明状态栏,这就是上文效果图用API区分的原因。

注:以下style样式同上代码,但是有兼容问题,建议直接使用代码设置
<item name="Android:windowTranslucentStatus">true</item>

第二步-padding出预留空间

设置透明状态栏之后,内容会顶到屏幕顶部会和状态栏中的内容重叠。

就需要设置padding出和状态栏相同的高度,防止重叠
有两种解决方法:

  1. XML中设置:对某个View设置android:fitsSystemWindows="true"(API+14)系统布局时自动找到最外层的View设置paddingTop

  2. 代码控制:确定状态栏高度然后给需要View设置paddingTop的值

在XML中直接设置属性比较简单,但是有局限性,只对最外层View有效,如果是Fragment的View视图中设置fitsSystemWindows然后被添加到屏幕上无效。
代码控制,能够解决Fragment的问题,但是确定状态栏高度有点麻烦,一般来说状态栏高度都是24dp,保险起见还是需要读取系统的配置高度,还有设置padding有时也会失效,就需要handler.post(new Runnable())来保证代码的执行

读取系统配置的状态栏高度代码:

    /**
     * 19API以上 读取到状态栏高度才有意义
     *
     * @param context
     * @return
     */
    static public int getStatusBarHeight(Context context) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            int resourceId = context.getResources().getIdentifier("status_bar_height", "dimen", "android");
            return resourceId > 0 ? context.getResources().getDimensionPixelSize(resourceId) : 0;
        } else {
            return 0;
        }
    }

第三步-着色

这里先说明前两步的结果;

  • API<19:不执行
  • API=19:黑灰渐进透明的状态栏
  • API>=20:系统会自动生成一个半透明的状态栏

所以就需要我们对第二步中产生的预留空间设置颜色,同样有两种方法:

  1. 添加View:对整个视图的父容器FrameLayout(ID=android.R.id.content)添加一个状态栏高度带有颜色的View,覆盖到状态栏。
  2. 自动渲染:对设置了paddingTop的控件,设置背景色,当该控件被padding处理时,颜色也同时渲染到了状态栏中。

添加覆盖状态栏View的代码:

    /**
     * 设置状态栏颜色为App主色
     * 配合{@link #setTranslucentWindows(Activity)}方法使用
     * 主要方法为添加一个View并设置背景色添加到系统contentView中
     *
     * @param activity
     */
    static public void addStatusBarBackground(Activity activity) {
        int height;
        height = getStatusBarHeight(activity);
        if (height <= 0) {
            return;
        }
        FrameLayout layout = (FrameLayout) activity.findViewById(android.R.id.content);
        FrameLayout statusLayout = new FrameLayout(activity);
        statusLayout.setLayoutParams(new LinearLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, height));

        TypedValue typedValue = new TypedValue();
        TypedArray a = activity.obtainStyledAttributes(typedValue.data, new int[]{R.attr.colorPrimary});
        int color = a.getColor(0, 0);
        a.recycle();
        statusLayout.setBackgroundColor(color);
        layout.addView(statusLayout);
    }

特殊的API21+

当API21+:能够调用系统API直接对状态栏着色
if(Build.VERSION.SDK_INT>=Build.VERSION_CODES.LOLLIPOP){
    this.getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
    this.getWindow().setStatusBarColor(ContextCompat.getColor(this,R.color.red_normal));
}

总结

实现状态栏着色并不复杂,只需要三步,真正使用时其实就是几行代码或者几个方法调用。但是在实际使用中需要考虑实际需求,兼容问题。搭配使用每一步的使用就能实现我们想要的效果。

如上文的效果图实现就是:Activity状态栏透明,导航搜索栏View背景色透明paddingTop状态栏高度,覆盖在图片之上,而图片没有任何控制。