Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/laobie/StatusBarUtil

A util for setting status bar style on Android App.
https://github.com/laobie/StatusBarUtil

android statusbar statusbarutil utils

Last synced: 3 months ago
JSON representation

A util for setting status bar style on Android App.

Host: GitHub
URL: https://github.com/laobie/StatusBarUtil
Owner: laobie
License: apache-2.0
Created: 2016-02-15T03:06:06.000Z (almost 9 years ago)
Default Branch: master
Last Pushed: 2022-06-24T09:55:37.000Z (over 2 years ago)
Last Synced: 2024-10-22T09:51:23.075Z (3 months ago)
Topics: android, statusbar, statusbarutil, utils
Language: Java
Homepage: http://t.cn/Rq746Kb
Size: 8.93 MB
Stars: 8,809
Watchers: 182
Forks: 1,723
Open Issues: 111
Metadata Files:
- Readme: README.md
- Changelog: CHANGE_LOG.md
- License: LICENSE.md

Awesome Lists containing this project

-awesome-android-ui - StatusBarUtil - 2.0) | <img src="/art/StatusBarUtil.png" width="100%"> (Index `(light-weight pages)`)
awesome-android-ui - StatusBarUtil - 2.0) | <img src="/art/StatusBarUtil.png" width="100%"> (Index `(light-weight pages)`)
awesome-github-android-ui - StatusBarUtil - 为Android应用设置状态栏 (状态栏)
awesome-android-ui - StatusBarUtil - 2.0) | <img src="/art/StatusBarUtil.png" width="100%"> (Index)

README

        # StatusBarUtil

[![996.icu](https://img.shields.io/badge/link-996.icu-red.svg)](https://996.icu)

[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-StatusBarUtil-green.svg?style=true)](https://android-arsenal.com/details/1/3341)

[ ![Download](https://api.bintray.com/packages/laobie/maven/StatusBarUtil/images/download.svg) ](https://bintray.com/laobie/maven/StatusBarUtil/_latestVersion)

A util for setting status bar style on Android App. It can work above API 19(KitKat 4.4).

[中文版点我](http://laobie.github.io/android/2016/03/27/statusbar-util.html)

![](https://s9.postimg.cc/3p0itrz67/DRIVE_2.png)

### Sample

[Download StatusBarUtil-Demo](http://fir.im/5mnp)

### ChangeLog 

[CLICK ME](CHANGE_LOG.md)

### Usage

1. Add the dependencies to your build.gradle file, StatusBarUtil is avaiable in JCenter:

   ```groovy

   compile 'com.jaeger.statusbarutil:library:1.5.1'

   ```

   I fixed typo, change "statusbaruitl" to "statusbarutil", please notice this.

2. Call method you need after `setContentView()`,  such as :

   ```java

   setContentView(R.layout.main_activity);

   ...

   StatusBarUtil.setColor(MainActivity.this, mColor);

   ```

3. If you use this util in a page which containing a `DrawerLayout`, you need add `android:fitsSystemWindows="true"` for `DrawerLayout` in your layout XML:

   ```xml

   

       ...

   

   ```

4. Set color for swipe back page

   Recommend using  with [bingoogolapple/BGASwipeBackLayout\-Android: Android Activity 滑动返回](https://github.com/bingoogolapple/BGASwipeBackLayout-Android)

   ```java

   StatusBarUtil.setColorForSwipeBack(Activity activity, @ColorInt int color, int statusBarAlpha)

   ```

5. All `statusBarAlpha` value you set should between 0 ~ 255

6. How to use in Fragment, please read [UseInFragmentActivity.java](https://github.com/laobie/StatusBarUtil/blob/master/sample/src/main/java/com/jaeger/statusbarutil/UseInFragmentActivity.java) 

   Handle all Fragments in ViewPager as ImageViewFragment, add a fake View in your Fragment layout as StatusBar :

   ```xml

   

   

       

          

   

   ```

   The fake StatusBar View height value ` statusbar_view_height`  defined in `dimens.xml`

   ```xml

   ~ values-v19/dimens.xml

   25dp

   ~ values/dimens.xml

   0dp

   ```

   When you change StatusBarColor :

   ```java

   mFakeStatusBar.setBackgroundColor(color);

   ```

   Then in the Activity which contains ViewPage, just invoke

   ```java

   StatusBarUtil.setTranslucentForImageViewInFragment(UseInFragmentActivity.this, null);

   ```

   Please read [UseInFragmentActivity.java](https://github.com/laobie/StatusBarUtil/blob/master/sample/src/main/java/com/jaeger/statusbarutil/UseInFragmentActivity.java) 

### Features

- Set status bar color

  ```java

  StatusBarUtil.setColor(Activity activity, int color)

  ```

  ![](img/set_color.png)

- Set status bar translucent

  ```java

  StatusBarUtil.setTranslucent(Activity activity, int statusBarAlpha)

  ```

  ![](img/set_translucnet.png)

- Set status bar transparent

  ```java

  StatusBarUtil.setTransparent(Activity activity)

  ```

  ![](img/set_transparent.png)

- Set status bar color for `DrawerLayout`

  ```java

  StatusBarUtil.setColorForDrawerLayout(Activity activity, DrawerLayout drawerLayout, int color)

  ```

  ![](img/set_color_for_drawer_layout.png)

- Set translucent status bar for using ImageView as head view page

  ```java

    StatusBarUtil.setTranslucentForImageView(Activity activity, int statusBarAlpha, View needOffsetView)

  ```

   ![](img/set_for_image_view_page.png)

- Set Light or Dark mode

  ```

    StatusBarUtil.setLightMode(Activity activity)

    StatusBarUtil.setDarkMode(Activity activity)

  ```

    ![](img/switch_light_mode.jpeg)

- Use in fragment

   ![](img/use_in_fragment.gif)

- Set color for swipe back page

  ```java

    StatusBarUtil.setColorForSwipeBack(Activity activity, @ColorInt int color, int statusBarAlpha)

  ```

    ![](img/set_color_for_swipe_back_page.png)

- Pass statusBarAlpha param when necessary to change your status bar alpha, which is 112 by default.

### License

	Copyright 2016 Jaeger Chen

	Licensed under the Apache License, Version 2.0 (the "License");	you may not use this file except in compliance with the License.

	You may obtain a copy of the License at

	

		http://www.apache.org/licenses/LICENSE-2.0

	

	Unless required by applicable law or agreed to in writing, software

	distributed under the License is distributed on an "AS IS" BASIS,

	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

	See the License for the specific language governing permissions and

	limitations under the License.