React Native未来导航者：react-navigation 使用详解

发布时间：2020-12-15 07:14:11 所属栏目：百科来源：网络整理

导读：上篇博客和大家分享了关于ReactNative jsBundle预加载，界面启动优化的内容，详情可点击：转自：http://blog.csdn.NET/u013718120/article/details/72357698 基于最新版本React Native实现JsBundle预加载，界面秒开优化一、开源库介绍今年1月份，新开源的

上篇博客和大家分享了关于ReactNative jsBundle预加载，界面启动优化的内容，详情可点击：

转自：http://blog.csdn.NET/u013718120/article/details/72357698

基于最新版本React Native实现JsBundle预加载，界面秒开优化

一、开源库介绍

今年1月份，新开源的React-natvigation库备受瞩目。在短短不到3个月的时间，github上星数已达4000+。Fb推荐使用库，并且在React Native当前最新版本0.44中将Navigator删除。react-navigation据称有原生般的性能体验效果。可能会成为未来React Native导航组件的主流军。本篇内容基于【 ^1.0.0-beta.9 】版本来介绍关于该库的使用和实战技巧。可以看到，虽然是beta版本，不过基本稳定，大家可放心在项目中使用。该库包含三类组件：

（1）StackNavigator：用来跳转页面和传递参数

（2）TabNavigator：类似底部导航栏，用来在同一屏幕下切换不同界面

（3）DrawerNavigator：侧滑菜单导航栏，用于轻松设置带抽屉导航的屏幕

二、react-navigation使用

具体内容大致分为如下：

（1）react-navigation库属性介绍

（2）StackNavigator、TabNavigator实现界面间跳转，Tab切换

（3）StackNavigator界面间跳转、传值、取值

（4）DrawerNavigator实现抽屉导航菜单

（5）DrawerNavigator扩展功能

（6）修改源码，定制UI界面

1、StackNavigator属性介绍

[html] 
    view plain 
    copy 
     
    
 
    
 navigationOptions：配置StackNavigator的一些属性。
 
 title：标题，如果设置了这个导航栏和标签栏的title就会变成一样的，不推荐使用
 header：可以设置一些导航的属性，如果隐藏顶部导航栏只要将这个属性设置为null
 headerTitle：设置导航栏标题，推荐
 headerBackTitle：设置跳转页面左侧返回箭头后面的文字，默认是上一个页面的标题。可以自定义，也可以设置为null
 headerTruncatedBackTitle：设置当上个页面标题不符合返回箭头后的文字时，默认改成"返回"
 headerRight：设置导航条右侧。可以是按钮或者其他视图控件
 headerLeft：设置导航条左侧。可以是按钮或者其他视图控件
 headerStyle：设置导航条的样式。背景色，宽高等
 headerTitleStyle：设置导航栏文字样式
 headerBackTitleStyle：设置导航栏‘返回’文字样式
 headerTintColor：设置导航栏颜色
 headerPressColorAndroid：安卓独有的设置颜色纹理，需要安卓版本大于5.0
 gesturesEnabled：是否支持滑动返回手势，iOS默认支持，安卓默认关闭
 
 screen：对应界面名称，需要填入import之后的页面
 mode：定义跳转风格
 card：使用iOS和安卓默认的风格
 modal：iOS独有的使屏幕从底部画出。类似iOS的present效果
 headerMode：返回上级页面时动画效果
 float：iOS默认的效果
 screen：滑动过程中，整个页面都会返回
 none：无动画
 cardStyle：自定义设置跳转效果
 transitionConfig：自定义设置滑动返回的配置
 onTransitionStart：当转换动画即将开始时被调用的功能
 onTransitionEnd：当转换动画完成，将被调用的功能
 path：路由中设置的路径的覆盖映射配置
 initialRouteName：设置默认的页面组件，必须是上面已注册的页面组件
 initialRouteParams：初始路由参数

注：大家可能对于path不太理解。path属性适用于其他app或浏览器使用url打开本app并进入指定页面。path属性用于声明一个界面路径，例如：【/pages/Home】。此时我们可以在手机浏览器中输入：app名称://pages/Home来启动该App，并进入Home界面。

2、TabNavigator属性介绍

copy

screen：和导航的功能是一样的，对应界面名称，可以在其他页面通过这个screen传值和跳转。

navigationOptions：配置TabNavigator的一些属性
title：标题，会同时设置导航条和标签栏的title
tabBarVisible：是否隐藏标签栏。默认不隐藏(true)
tabBarIcon：设置标签栏的图标。需要给每个都设置
tabBarLabel：设置标签栏的title。推荐
导航栏配置
tabBarPosition：设置tabbar的位置，iOS默认在底部，安卓默认在顶部。（属性值：'top'，'bottom'）
swipeEnabled：是否允许在标签之间进行滑动
animationEnabled：是否在更改标签时显示动画
lazy：是否根据需要懒惰呈现标签，而不是提前，意思是在app打开的时候将底部标签栏全部加载，默认false,推荐为true
trueinitialRouteName：设置默认的页面组件
backBehavior：按back键是否跳转到第一个Tab(首页)，none为不跳转
tabBarOptions：配置标签栏的一些属性iOS属性
activeTintColor：label和icon的前景色活跃状态下
activeBackgroundColor：label和icon的背景色活跃状态下
inactiveTintColor：label和icon的前景色不活跃状态下
inactiveBackgroundColor：label和icon的背景色不活跃状态下
showLabel：是否显示label，默认开启style：tabbar的样式
labelStyle：label的样式安卓属性
showIcon：是否显示图标，默认关闭
labelStyle：label的样式upperCaseLabel：是否使标签大写，默认为true
pressColor：material涟漪效果的颜色（安卓版本需要大于5.0）
pressOpacity：按压标签的透明度变化（安卓版本需要小于5.0）
scrollEnabled：是否启用可滚动选项卡tabStyle：tab的样式
indicatorStyle：标签指示器的样式对象（选项卡底部的行）。安卓底部会多出一条线，可以将height设置为0来暂时解决这个问题
labelStyle：label的样式
iconStyle：图标样式

3、DrawerNavigator属性介绍

copy

DrawerNavigatorConfig

drawerWidth-抽屉的宽度
drawerPosition-选项是左或右。默认为左侧位置
contentComponent-用于呈现抽屉内容的组件，例如导航项。接收抽屉的导航。默认为DrawerItems
contentOptions-配置抽屉内容
initialRouteName-初始路由的routeName
order-定义抽屉项目顺序的routeNames数组。
路径-提供routeName到路径配置的映射，它覆盖routeConfigs中设置的路径。
backBehavior-后退按钮是否会切换到初始路由？如果是，设置为initialRoute，否则为none。默认为initialRoute行为
DrawerItems的contentOptions属性
activeTintColor-活动标签的标签和图标颜色
activeBackgroundColor-活动标签的背景颜色
inactiveTintColor-非活动标签的标签和图标颜色
inactiveBackgroundColor-非活动标签的背景颜色
内容部分的样式样式对象
labelStyle-当您的标签是字符串时，要覆盖内容部分中的文本样式的样式对象

从上述中大致了解了react-navigation三种组件的一些基本属性，所以到我们甩起袖子撸代码见证下奇迹了。

4、使用StackNavigator + TabNavigator实现Tab界面切换、界面间导航

API定义：StackNavigator(RouteConfigs,StackNavigatorConfig)、TabNavigator(RouteConfigs,TabNavigatorConfig)

（1）集成 react-navigation：在终端执行【 npm install react-navigation --save 】

（2）界面中导入必要组件：

copy

import{StackNavigator,TabNavigator,TabBarBottom}from'react-navigation';

importHomeScreenfrom'./pages/HomePage';
importMineScreenfrom'./pages/MinePage';

（3）定义TabNavigator：

copy

constTab=TabNavigator(

{
Home:{
screen:HomeScreen,
navigationOptions:({navigation})=>({
tabBarLabel:'首页',108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> tabBarIcon:({focused,tintColor})=>(
<TabBarItem
tintColor={tintColor}
focused={focused}
normalImage={require('./imgs/nav_fav@2x.png')}
selectedImage={require('./imgs/nav_fav_actived@3x.png')}
/>
)
}),
},248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> Mine:{
screen:MineScreen,248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> navigationOptions:({navigation})=>({
tabBarLabel:'我',248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> tabBarIcon:({focused,0); margin:0px; padding:0px; border:none; background-color:inherit; font-weight:bold">>(
TabBarItem
tintColor={tintColor}
focused={focused}
normalImage={require('./imgs/tab_me_nor@3x.png')}
selectedImage={require('./imgs/tab_me_selected@2x.png')}
/>
)
}),108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> },108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> tabBarComponent:TabBarBottom,248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> tabBarPosition:'bottom',108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> swipeEnabled:false,248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> animationEnabled:false,108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> lazy:true,248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> tabBarOptions:{
activeTintColor:'#06c1ae',248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> inactiveTintColor:'#979797',108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> style:{backgroundColor:'#ffffff',},248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> labelStyle:{
fontSize:20,//文字大小
}
);

TabBarItem为封装的组件：
copy

importReact,{Component}from'react';

import{Image}from'react-native';
exportdefaultclassTabBarItemextendsComponent{
render(){
return(
Imagesource={this.props.focused?this.props.selectedImage:this.props.normalImage}
style={{tintColor:this.props.tintColor,width:25,height:25}}
}
}

可以看到，我们定义了一个名称为【Tab】的TabNavigator的导航组件。在组件中，分为两层参数：
（1）第一层参数定义了要切换的界面，即【首页】、【我】两个界面组件，通过screen属性指定。并且通过navigationOptions属性设置相关属性参数。
（2）设置导航栏的属性参数。
TabNavigator定义好之后，需要用StackNavigator，顾名思义，StackNavigator就是以栈的方式来存放整个界面的，而TabNavigator是作为一个界面内不同子界面之间切换。所以还需要我们定义StackNavigator：
copy

constNavigator=StackNavigator(

{
Tab:{screen:Tab},108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> Product:{screen:ProductScreen}
navigationOptions:{
headerBackTitle:null,108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> headerTintColor:'#333333',248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> showIcon:true,108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> mode:'card',248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> });

看起来和TabNavigator很相似，同样是指定了两个参数：
（1）指定要跳转的界面组件。同样是screen属性标识界面组件，不多赘述。
（2）定义跳转属性参数，即顶部导航栏的一些参数设置和跳转方式。
可以看到，我们将Tab作为一个界面设置到了StackNavigator。这样就可以实现Tab导航和界面间跳转的效果了。
最后就是在render中引用StackNavigator：
copy

exportdefaultclassDemoextendsComponent{

render(){
return(
Navigator );
StackNavigator还提供了onNavigationStateChange回调方法，用来监听导航状态的改变。具体不再赘述。实现了界面跳转和切换，那么就该来增加下界面之间的感情了，来看看如何实现界面之间的传值和取值。

5、界面间跳转、传值、取值

在界面组件注入到StackNavigator中时，界面组件就被赋予了navigation属性，即在界面组件中可以通过【this.props.navigation】获取并进行一些操作。

navigation属性中提供了很多的函数简化界面间操作，简单列举几点：

（1）通过navigate函数实现界面之间跳转：

copy
参数为我们在StackNavigator注册界面组件时的名称。同样也可以从当前页面返回到上一页：
copy
1. this.props.navigation.goBack();
（2）跳转时传值：
copy
第一个参数同样为要跳转的界面组件名称，第二个参数为要传递的参数，info可以理解为key，后面即传递的参数。
（3）获取值：

copy
通过state.params来获取传来的参数，后面为key值。此处为info。
以上实现完成，我们就可以愉快的玩耍啦~~ 什么？忽然发现在Android上的效果和IOS效果不一样。老板要界面一致哇~ 怎么办？那就需要我们进行简单的适配了。

三、DrawerNavigator实现抽屉导航

1、导航实现
API定义：DrawerNavigator（RouteConfigs，DrawerNavigatorConfig）
（1）界面中定义DrawerNavigator：
copy
1. exportdefaultclassDemoextendsComponent{
2. constNavigator=DrawerNavigator({
3. Home:{screen:HomeScreen},108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> Mine:{screen:MineScreen},248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> });
4. conststyles=StyleSheet.create({
5. container:{
6. flex:1,108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> });
7. AppRegistry.registerComponent('Demo',()=>Demo);
定义方式和StackNavigator基本类似，不再赘述。
（2）HomeScreen界面和MineScreen界面：
copy
1. staticnavigationOptions={
2. drawerLabel:'首页',108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> drawerIcon:({tintColor})=Image
3. source={require('./../imgs/ic_happy.png')}
4. style={[styles.icon,{tintColor:tintColor}]} ),248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> };
5. Viewstyle={{flex:1}}>
6. TextonPress={this._skip.bind(this)}>点击跳转</Text>
7. View );
8. _skip(){
9. this.props.navigation.navigate("Mine");
10. exportdefaultclassMinePageextendsComponent{
11. staticnavigationOptions={
12. drawerLabel:'我',248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> drawerIcon:({tintColor})=Image
13. source={require('./../imgs/ic_h.png')}
14. style={[styles.icon,{tintColor:tintColor}]}
15. >返回上一界面 /**
16. *跳转
17. */
18. _skip(){
19. this.props.navigation.goBack();
20. 代码很简单，实现了界面之间的跳转。
  2、扩展功能
  （1）默认DrawerView不可滚动。要实现可滚动视图，必须使用contentComponent自定义容器，如下所示：
  copy
  1. drawerWidth：200，
  2. 抽屉位置：“对”
  3. contentComponent：props=>ScrollViewDrawerItems{...props}/></ }
  （2）可以覆盖导航使用的默认组件，使用DrawerItems自定义导航组件：
  copy
  1. constCustomDrawerContentComponent=(props)=Viewstyle={style.container}（3）嵌套抽屉导航
    如果您嵌套DrawerNavigation，抽屉将显示在父导航下方。
    
    四、react-navigation源码定制
    
    （1）适配顶部导航栏标题：
    测试中发现，在iphone上标题栏的标题为居中状态，而在Android上则是居左对齐。所以需要我们修改源码，进行适配。
    【node_modules -- react-navigation -- src -- views -- Header.js】的326行代码处，修改为如下：
    copy
    1. bottom:0,108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> left:TITLE_OFFSET,248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> right:TITLE_OFFSET,108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> top:0,248); line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> position:'absolute',108); list-style:decimal-leading-zero outside; color:inherit; line-height:20px; margin:0px!important; padding:0px 3px 0px 10px!important"> alignItems:'center',85); font-family:Arial; font-size:14px; line-height:26px">（2）去除返回键文字显示：
      【node_modules -- react-navigation -- src -- views -- HeaderBackButton.js】的91行代码处，修改为如下即可。
      copy
      
      {Platform.OS==='ios'&&
      title&&
      
      Text
      
      onLayout={this._onTextLayout}
      
      style={[styles.title,{color:tintColor}]}
      
      numberOfLines={1}
      
      {backButtonTitle}
      
      >}
      
      将上述代码删除即可。
      （3）设置标题栏的按钮单击事件：
      因为在界面组件中设置标题参数时，需要将navigationOptions定义成static。所以我们不能直接通过this.xxx.bind(this)来调用自定义函数，怎么办呢？可以通过如何方式解决：
      copy
      
      classdemoextendsComponent{
      staticnavigationOptions=({navigation})= right:(ButtononPress={state.params.clickParams}/>)
      
      })
      
      _btnClick=()=>{
      
      alert('单击')
      
      componentWillMount(){
      
      this.props.navigation.setParams({clickParams:this._btnClick})
      
      （4）动态设置标题栏显示和隐藏
      根据（3）中的思想，我们可以利用setParams来动态修改状态栏的显示和隐藏：
      copy
      
      staticnavigationOptions=({navigation})= visible:state.params.headerState,0); background-color:inherit; font-weight:bold">Button
      title="HideHeader"
      
      onPress={()=>this.props.navigation.setParams({headerState:'none'})}
      
      />)
      
      }
      
      五、效果图
      抽屉导航：
      
      以上就是我们实战中常用的属性和技巧。具体的操作还需要大家在实践过程中测试体会。
      （编辑：李大同）
      
      【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!

React Native未来导航者：react-navigation 使用详解

基于最新版本React Native实现JsBundle预加载，界面秒开优化

一、开源库介绍

二、react-navigation使用

三、DrawerNavigator实现抽屉导航

四、react-navigation源码定制