不得不看之ReactNative中的状态栏
预备知识
成都创新互联公司为企业级客户提高一站式互联网+设计服务,主要包括网站设计制作、成都网站建设、成都app软件开发、重庆小程序开发公司、宣传片制作、LOGO设计等,帮助客户快速提升营销能力和企业形象,创新互联各部门都有经验丰富的经验,可以确保每一个作品的质量和创作周期,同时每年都有很多新员工加入,为我们带来大量新的创意。
在正式开始之前,我先介绍一些我目前了解下来的相关知识,为后面的内容进行一些铺垫。
iOS 中的状态栏
在 iOS 中,页面默认全屏(状态栏不占空间),状态栏内容默认是深色。因为页面全屏,所以如果我们不进行处理,内容会跑到状态栏下面去。同时,由于 iPhone X 等刘海屏手机的出现,导致状态栏的高度发生了变化,由之前的 20
变成了 34
。为了解决此问题,我们可以手动给顶部组件设置 paddingTop
(值根据机型判断),或者使用 SafeAreaView
组件。
在 iOS 中我们只用处理好安全区域的问题,然后根据页面的不同去设置内容的颜色深浅即可。
Android 中的状态栏
在 Android 中,页面默认非全屏(状态栏占空间),状态栏内容默认是浅色。
Android 中对状态栏的支持经历了几个版本:
Android4.4(API 19) ~ Android 5.0(API 21):通过
FLAG_TRANSLUCENT_STATUS
设置页面为全屏且状态栏半透明(浅灰色)。Android 5.0(API 21):提供了
droid:statusBarColor
属性和setStatusBarColor
方法用来设置状态栏的颜色。Android 6.0(API 23):通过
SYSTEM_UI_FLAG_LIGHT_STATUS_BAR
支持设置状态栏内容为深色。
其中,如果想要设置状态栏颜色,则不能设置 FLAG_TRANSLUCENT_STATUS
。
在 Android 应用中,每个 Activity 都对应一个状态栏。这意味着,为一个页面设置状态栏不会对其他页面的状态栏造成影响。
React Native 中的状态栏
React Native 官方提供了 StatusBar
组件用于控制状态栏,支持设置内容深浅色,状态栏背景(Android)等。
StatusBar
可以同时添加多个,而属性则会按照加载顺序合并(后者覆盖前者)。
不同于 Android 中的状态栏,在 React Native 中状态栏是公用的,任何一个地方修改状态栏都会导致状态栏发生变化,即使切换到了其他未设置的页面。因此,我们需要在每个页面渲染时都设置一下相应的状态栏,或是在离开设置了状态栏的页面时重置状态栏。
实际案例
在了解了必要的知识后,让我们通过一个实际案例来看看我们需要做什么以及怎么做才更好。
在这个案例中,有三个页面:主页,我的,登录。其中“主页”和“我的”是两个标签页,“主页”头部有背景图片,“我的”页面顶部是蓝色,“登录”页面顶部为白色。页面效果如下图。
“主页”和“我的”页面使用自定义的 Header,该组件会根据当前设备,获取状态栏的高度:
const STATUS_BAR_HEIGHT = isiOS() ? (isiPhoneX() ? 34 : 20) : StatusBar.currentHeight
其中判断设备使用的下面的方法:
// iPhone X、iPhone XS const X_WIDTH = 375; const X_HEIGHT = 812; // iPhone XR、iPhone XS Max const XSMAX_WIDTH = 414; const XSMAX_HEIGHT = 896; const DEVICE_SIZE = Dimensions.get('window'); const { height: D_HEIGHT, width: D_WIDTH } = DEVICE_SIZE; export const isiOS = () => Platform.OS === 'ios' export const isiPhoneX = () => { return ( isiOS() && ((D_HEIGHT === X_HEIGHT && D_WIDTH === X_WIDTH) || (D_HEIGHT === X_WIDTH && D_WIDTH === X_HEIGHT)) || ((D_HEIGHT === XSMAX_HEIGHT && D_WIDTH === XSMAX_WIDTH) || (D_HEIGHT === XSMAX_WIDTH && D_WIDTH === XSMAX_HEIGHT)) ); };
获取到状态栏的高度之后,根据当前是不是全屏(fullSreen
属性为 true
或者是 iOS 设备)来设置自身高度和 paddingTop
,标题栏高度统一设置为 44
。
const headerStyle = [ styles.header, (fullScreen || isiOS()) && { height: STATUS_BAR_HEIGHT + HEADER_HEIGHT, paddingTop: STATUS_BAR_HEIGHT } ]
“登录”页面的 Header 则是 react-navigation
默认的 Header 组件,在 Android 中标题栏高度被设置为 56
。
处理状态栏的问题
从上图的案例中,可以发现以下几点问题:
iOS 设备中,状态栏内容的颜色显示不正确,“主页”和“我的”页面状态栏应该是浅色。
Android 设备中,“主页”的状态栏应该是透明的,并且图片应该延伸到状态栏下。
Android 设备中,“我的”页面状态栏颜色应该也是蓝色。
为了让应用表现得更好,我们需要根据页面动态的调整状态栏。React Native 为开发者提供了 StatusBar 组件去控制状态栏。
StatusBar 组件控制状态栏
我们在“主页”中,设置状态栏内容为“浅色”,背景色为透明,translucent
为 true
。然后,“主页”和“我的”页面的 Header 都添加 fullScreen
属性。效果如下:
从图中可以看到,因为页面路由是 js 层做的,整个应用对应一个 StatusBar
,虽然“我的”和“登录”页面都没有设置状态栏,但状态栏也是透明的。
这样就有一个问题,“登录”页面其实使用默认效果即可,但是由于其他页面设置了状态栏,导致进入到“登录”页面时效果就不对了。所以,每个页面都需要设置相应的状态栏,因为状态栏可能被其他页面改变。
接下来,在“登录”页面设置状态栏为白色且内容为深色:
现在“登录”页面的效果就和期望的一样了,当我们从“登录”页面返回到主界面时,状态栏会切换回之前的状态,但是有一点延时。按照前面的经验,当从登录页面回来时,状态栏应该仍是白色且内容深色。因为返回时,前面的页面不会重新渲染,状态栏应该会保持当前的状态。但是状态栏却自动调整成了之前的状态,虽然有一点延时。我在 react-navigation
的 GitHub issue 中发现有人提到,当离开 route
时,会自动的重设状态栏。我没有具体研究,但我认同这一点,这必然是某处做了此类处理。
那为什么会有延时呢?我猜测这应该是自动重置状态栏的时机导致的。我尝试增加了一个注册页面(由登录页面点击按钮进入),并设置状态栏为红色。然后,我在登录页面监听了 willFocus
和 didFocus
事件,分别在事件的处理函数中,将状态栏设置为白色。结果是,在 willFocus
中处理是我们期望的结果,而 didFocus
中处理和默认不处理时是一样的。
到这里,我们基本可以得出一个结论:如果我们要在 app 中调整状态栏,稳妥的做法是在每一个页面 willFocus
时设置其相应的状态栏,除非能确保前一个页面的状态栏和自身相同。
因为这个功能十分通用,所以我们可以通过一个高阶组件来完成这件事:
import React from 'react' import hoistNonReactStatics from 'hoist-non-react-statics' import { StatusBar } from 'react-native' import { isAndroid } from '../../utils/device' export const setStatusBar = (statusbarProps = {}) => WrappedComponent => { class Component extends React.PureComponent { constructor(props) { super(props) this._navListener = props.navigation.addListener('willFocus', this._setStatusBar) } componentWillUnmount() { this._navListener.remove(); } _setStatusBar = () => { const { barStyle = "dark-content", backgroundColor = '#fff', translucent = false } = statusbarProps StatusBar.setBarStyle(barStyle) if (isAndroid()) { StatusBar.setTranslucent(translucent) StatusBar.setBackgroundColor(backgroundColor); } } render() { return} } return hoistNonReactStatics(Component, WrappedComponent); }
通过装饰器的方式使用也十分简单:
@setStatusBar({ barStyle: 'light-content', translucent: true, backgroundColor: 'transparent'}) export default class Home extends React.PureComponent { ... }
设置 Android 全屏且状态栏透明
除了在 js 层通过 StatusBar
组件设置状态栏的颜色、半透明等,我们也可以先将 Android 的状态栏设置为全屏且状态栏透明,这样 Android 的表现就和 iOS 一样,可以统一的去处理。
在 MainActivity.java
中添加下面的代码,可以设置全屏且状态栏透明:
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); View decorView = getWindow().getDecorView(); decorView.setSystemUiVisibility(View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_LAYOUT_STABLE); if (Build.VERSION.SDK_INT >= 21) { getWindow().setStatusBarColor(Color.TRANSPARENT); } }
设置完成后的效果如下图(没有处理 paddingTop
)。
现在 Android 状态栏的表现就和 iOS 一样了,处理的时候统一按照 iOS 的处理逻辑即可,只是在 Header 的高度以及 paddingTop
的计算上不同。
此外,还需要注意 react-native
的 Header 没有处理 Android 全屏的情况,因此我们需要在 Android 平台下修改 headerStyle
:
defaultNavigationOptions: { headerStyle: { ...Platform.OS === 'android' && { height: StatusBar.currentHeight + 44, paddingTop: StatusBar.currentHeight } } }
总结
React Native 中想要让状态栏表现得更好还是需要做一些工作的。现在看来其实使用 StatusBar
组件更加的容易一点,因为即使在 Android 原生层面设置了全屏和透明状态栏,最后还是需要根据页面去设置状态栏内容的颜色,所以还不许统一的在 js 层去做,通过高阶组件的方式也不是很麻烦。
觉得文章不错的喜欢的小伙伴可以关注加转发,欢迎大家前来探讨交流,同时,我也非常欢迎大家互相交流技术,共同成长。
分享文章:不得不看之ReactNative中的状态栏
当前网址:http://scyanting.com/article/gphcgo.html