关于React Navigation的一些使用技巧

一、开源库介绍


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


该库包含三类组件:

(1)StackNavigator:用来跳转页面和传递参数

(2)TabNavigator:类似底部导航栏,用来在同一屏幕下切换不同界面

(3)DrawerNavigator:侧滑菜单导航栏,用于轻松设置带抽屉导航的屏幕


二、react-navigation使用


具体内容大致分为如下:

(1)react-navigation库属性介绍

(2)StackNavigator、TabNavigator实现界面间跳转,Tab切换

(3)StackNavigator界面间跳转、传值、取值

(4)DrawerNavigator实现抽屉导航菜单

(5)DrawerNavigator扩展功能

(6)自定义react-navigation


1、StackNavigator属性介绍

  1. navigationoptions:配置StackNavigator的一些属性
  2. title:标题,如果设置了这个导航栏和标签栏的title就会变成一样的,不推荐使用
  3. header:可以设置一些导航的属性,如果隐藏顶部导航栏只要将这个属性设置为null
  4. headerTitle:设置导航栏标题,推荐
  5. headerBackTitle:设置跳转页面左侧返回箭头后面的文字认是上一个页面标题。可以自定义,也可以设置为null
  6. headerTruncatedBackTitle:设置当上个页面标题不符合返回箭头后的文字时,认改成”返回”
  7. headerRight:设置导航条右侧。可以是按钮或者其他视图控件
  8. headerLeft:设置导航条左侧。可以是按钮或者其他视图控件
  9. headerStyle:设置导航条的样式。背景色,宽高等
  10. headerTitleStyle:设置导航栏文字样式
  11. headerBackTitleStyle:设置导航栏‘返回’文字样式
  12. headerTintColor:设置导航栏颜色
  13. headerPressColorAndroid:安卓独有的设置颜色纹理,需要安卓版本大于5.0
  14. gesturesEnabled:是否支持滑动返回手势,iOS支持,安卓关闭
  15. screen:对应界面名称,需要填入import之后的页面
  16. mode:定义跳转风格
  17. card:使用iOS和安卓认的风格
  18. modal:iOS独有的使屏幕从底部画出。类似iOS的present效果
  19. headerMode:返回上级页面时动画效果
  20. float:iOS认的效果
  21. screen:滑动过程中,整个页面都会返回
  22. none:无动画
  23. cardStyle:自定义设置跳转效果
  24. transitionConfig自定义设置滑动返回的配置
  25. onTransitionStart:当转换动画即将开始时被调用功能
  26. ontransitionend:当转换动画完成,将被调用功能
  27. path:路由中设置的路径的覆盖映射配置
  28. initialRouteName:设置认的页面组件,必须是上面已注册页面组件
  29. initialRouteParams:初始路由参数
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属性介绍

  1. screen:和导航的功能是一样的,对应界面名称,可以在其他页面通过这个screen传值和跳转
  2. navigationoptions:配置TabNavigator的一些属性
  3. title:标题,会同时设置导航条和标签栏的title
  4. tabBarVisible:是否隐藏标签栏。认不隐藏(true)
  5. tabBarIcon:设置标签栏的图标。需要给每个都设置
  6. tabBarLabel:设置标签栏的title。推荐
  7. 导航栏配置
  8. tabBarPosition:设置tabbar的位置,iOS认在底部,安卓认在顶部。(属性值:’top’,’bottom’)
  9. swipeEnabled:是否允许在标签之间进行滑动
  10. animationEnabled:是否在更改标签显示动画
  11. lazy:是否根据需要懒惰呈现标签,而不是提前,意思是在app打开的时候将底部标签栏全部加载,认false,推荐为true
  12. trueinitialRouteName:设置认的页面组件
  13. backBehavior:按back键是否跳转到第一个Tab(首页),none为不跳转
  14. tabBarOptions:配置标签栏的一些属性iOS属性
  15. activeTintColor:label和icon的前景色活跃状态下
  16. activeBackgroundColor:label和icon的背景色活跃状态下
  17. inactiveTintColor:label和icon的前景色不活跃状态下
  18. inactiveBackgroundColor:label和icon的背景色不活跃状态下
  19. showLabel:是否显示label,认开启style:tabbar的样式
  20. labelStyle:label的样式安卓属性
  21. activeTintColor:label和icon的前景色活跃状态下
  22. inactiveTintColor:label和icon的前景色不活跃状态下
  23. showIcon:是否显示图标,关闭
  24. showLabel:是否显示label,认开启style:tabbar的样式
  25. labelStyle:label的样式upperCaseLabel:是否使标签大写,认为true
  26. pressColor:material涟漪效果的颜色(安卓版本需要大于5.0)
  27. pressOpacity:按压标签的透明度变化(安卓版本需要小于5.0)
  28. scrollEnabled:是否启用可滚动选项卡tabStyle:tab的样式
  29. indicatorStyle:标签指示器的样式对象(选项卡底部的行)。安卓底部会多出一条线,可以将height设置为0来暂时解决这个问题
  30. labelStyle:label的样式
  31. iconStyle:图标样式
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的样式安卓属性

activeTintColor:label和icon的前景色 活跃状态下

inactiveTintColor:label和icon的前景色 不活跃状态下

showIcon:是否显示图标,关闭

showLabel:是否显示label,认开启 style:tabbar的样式

labelStyle:label的样式 upperCaseLabel:是否使标签大写,认为true

pressColor:material涟漪效果的颜色(安卓版本需要大于5.0)

pressOpacity:按压标签的透明度变化(安卓版本需要小于5.0)

scrollEnabled:是否启用可滚动选项卡 tabStyle:tab的样式

indicatorStyle:标签指示器的样式对象(选项卡底部的行)。安卓底部会多出一条线,可以将height设置为0来暂时解决这个问题

labelStyle:label的样式

iconStyle:图标样式

3、DrawerNavigator属性介绍

  1. DrawerNavigatorConfig
  2. drawerWidth-抽屉的宽度
  3. drawerPosition-选项是左或右。认为左侧位置
  4. contentComponent-用于呈现抽屉内容的组件,例如导航项。接收抽屉的导航。认为DrawerItems
  5. contentOptions-配置抽屉内容
  6. initialRouteName-初始路由的routeName
  7. order-定义抽屉项目顺序的routeNames数组。
  8. 路径-提供routeName到路径配置的映射,它覆盖routeConfigs中设置的路径。
  9. backBehavior-后退按钮是否会切换到初始路由?如果是,设置为initialRoute,否则为none。认为initialRoute行为
  10. DrawerItems的contentOptions属性
  11. activeTintColor-活动标签标签和图标颜色
  12. activeBackgroundColor-活动标签的背景颜色
  13. inactiveTintColor-非活动标签标签和图标颜色
  14. inactiveBackgroundColor-非活动标签的背景颜色
  15. 内容部分的样式样式对象
  16. labelStyle-当您的标签是字符串时,要覆盖内容部分中的文本样式的样式对象
 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)界面中导入必要组件:

  1. import{StackNavigator,TabNavigator,TabBarBottom}from‘react-navigation’;
  2. importHomeScreenfrom’./pages/HomePage’;
  3. importmineScreenfrom’./pages/minePage’;
import {StackNavigator,TabBarBottom} from 'react-navigation';
import HomeScreen from './pages/HomePage';
import mineScreen from './pages/minePage';
(3)定义TabNavigator:
  1. constTab=TabNavigator(
  2. {
  3. Home:{
  4. screen:HomeScreen,
  5. navigationoptions:({navigation})=>({
  6. tabBarLabel:’首页’,
  7. tabBarIcon:({focused,tintColor})=>(
  8. <TabBarItem
  9. tintColor={tintColor}
  10. focused={focused}
  11. normalImage={require(‘./imgs/nav_fav@2x.png’)}
  12. selectedImage={require(‘./imgs/nav_fav_actived@3x.png’)}
  13. />
  14. )
  15. }),
  16. },
  17. mine:{
  18. screen:mineScreen,
  19. navigationoptions:({navigation})=>({
  20. tabBarLabel:’我’,
  21. tabBarIcon:({focused,tintColor})=>(
  22. <TabBarItem
  23. tintColor={tintColor}
  24. focused={focused}
  25. normalImage={require(‘./imgs/tab_me_nor@3x.png’)}
  26. selectedImage={require(‘./imgs/tab_me_selected@2x.png’)}
  27. />
  28. )
  29. }),
  30. },
  31. {
  32. tabBarComponent:TabBarBottom,
  33. tabBarPosition:’bottom’,
  34. swipeEnabled:false,
  35. animationEnabled:false,
  36. lazy:true,
  37. tabBarOptions:{
  38. activeTintColor:’#06c1ae’,
  39. inactiveTintColor:’#979797’,
  40. style:{backgroundColor:’#ffffff’,},
  41. labelStyle:{
  42. fontSize:20,//文字大小
  43. },
  44. }
  45. }
  46. );
const Tab = TabNavigator(
  {
    Home:{
      screen:HomeScreen,navigationoptions:({navigation}) => ({
        tabBarLabel:'首页',tabBarIcon:({focused,tintColor}) => (
          <TabBarItem
            tintColor={tintColor}
            focused={focused}
            normalImage={require('./imgs/nav_fav@2x.png')}
            selectedImage={require('./imgs/nav_fav_actived@3x.png')}
          />
        )
      }),mine:{
          screen:mineScreen,navigationoptions:({navigation}) => ({
          tabBarLabel:'我',tintColor}) => (
            <TabBarItem
             tintColor={tintColor}
              focused={focused}
              normalImage={require('./imgs/tab_me_nor@3x.png')}
              selectedImage={require('./imgs/tab_me_selected@2x.png')}
            />
          )
        }),{
      tabBarComponent:TabBarBottom,tabBarPosition:'bottom',swipeEnabled:false,animationEnabled:false,lazy:true,tabBarOptions:{
        activeTintColor:'#06c1ae',inactiveTintColor:'#979797',style:{backgroundColor:'#ffffff',labelStyle: {
              fontSize: 20,// 文字大小
          },}

    }

  );
TabBarItem为封装的组件:
  1. importReact,{Component}from‘react’;
  2. import{Image}from‘react-native’;
  3. exportdefaultclasstabBarItemextendsComponent{
  4. render(){
  5. return(
  6. <Imagesource={this.props.focused?this.props.selectedImage:this.props.normalImage}
  7. style={{tintColor:this.props.tintColor,width:25,height:25}}
  8. />
  9. )
  10. }
  11. }
import React,{Component} from 'react';
import {Image} from 'react-native';

export default class TabBarItem extends Component {

    render() {
        return(
            <Image source={ this.props.focused ? this.props.selectedImage : this.props.normalImage }
                style={ { tintColor:this.props.tintColor,height:25 } }
            />
        )
    }

}
可以看到,我们定义了一个名称为【Tab】的TabNavigator的导航组件。在组件中,分为两层参数:

(1)第一层参数定义了要切换的界面,即【首页】、【我】两个界面组件,通过screen属性指定。并且通过navigationoptions属性设置相关属性参数。

(2)设置导航栏的属性参数。

TabNavigator定义好之后,需要用StackNavigator,顾名思义,StackNavigator就是以栈的方式来存放整个界面的,而TabNavigator是作为一个界面内不同子界面之间切换。所以还需要我们定义StackNavigator:
  1. constNavigator=StackNavigator(
  2. {
  3. Tab:{screen:Tab},
  4. Product:{screen:ProductScreen}
  5. },
  6. {
  7. navigationoptions:{
  8. headerBackTitle:null,
  9. headerTintColor:’#333333’,
  10. showIcon:true,
  11. mode:’card’,
  12. });
  const Navigator = StackNavigator(

    {
      Tab:{screen:Tab},Product:{screen:ProductScreen}
    },{
      navigationoptions:{
        headerBackTitle:null,headerTintColor:'#333333',showIcon:true,mode:'card',});
看起来和TabNavigator很相似,同样是指定了两个参数:

(1)指定要跳转的界面组件。同样是screen属性标识界面组件,不多赘述。

(2)定义跳转属性参数,即顶部导航栏的一些参数设置和跳转方式。

可以看到,我们将Tab作为一个界面设置到了StackNavigator。这样就可以实现Tab导航和界面间跳转效果了。

最后就是在render中引用StackNavigator:
  1. exportdefaultclassDemoextendsComponent{
  2. render(){
  3. return(
  4. <Navigator/>
  5. );
  6. }
  7. }
export default class Demo extends Component {

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


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


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

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

(1)通过navigate函数实现界面之间跳转

  1. this.props.navigation.navigate(‘mine’);
 this.props.navigation.navigate('mine');
参数为我们在StackNavigator注册界面组件时的名称。同样也可以从当前页面返回到上一页
  1. //返回上一页
  2. this.props.navigation.goBack();
// 返回上一页
this.props.navigation.goBack();
(2)跳转时传值:
  1. this.props.navigation.navigate(‘mine’,{info:’传值过去’});
this.props.navigation.navigate('mine',{info:'传值过去'});
一个参数同样为要跳转的界面组件名称,第二个参数为要传递的参数,info可以理解为key,后面即传递的参数。

(3)获取值:

  1. {this.props.navigation.state.params.info}
{this.props.navigation.state.params.info}
通过state.params来获取传来的参数,后面为key值。此处为info。

以上实现完成,我们就可以愉快的玩耍啦~~ 什么?忽然发现在Android上的效果和IOS效果不一样。老板要界面一致哇~ 怎么办?那就需要我们进行简单的适配了。


三、DrawerNavigator实现抽屉导航


1、导航实现

API定义:DrawerNavigator(RouteConfigs,DrawerNavigatorConfig

(1)界面中定义DrawerNavigator:
  1. import{StackNavigator,DrawerNavigator}from‘react-navigation’;
  2. importHomeScreenfrom’./pages/HomePage’;
  3. importmineScreenfrom’./pages/minePage’;
  4. exportdefaultclassDemoextendsComponent{
  5. render(){
  6. return(
  7. <Navigator/>
  8. );
  9. }
  10. }
  11. constNavigator=DrawerNavigator({
  12. Home:{screen:HomeScreen},
  13. mine:{screen:mineScreen},
  14. });
  15. conststyles=StyleSheet.create({
  16. container:{
  17. flex:1,
  18. });
  19. AppRegistry.registerComponent(‘Demo’,()=>Demo);
import {StackNavigator,DrawerNavigator} from 'react-navigation';
import HomeScreen from './pages/HomePage';
import mineScreen from './pages/minePage';

export default class Demo extends Component {

  render() {
        return (
          <Navigator />
        );
  }
}

const Navigator = DrawerNavigator({

    Home:{screen:HomeScreen},mine:{screen:mineScreen},});

const styles = StyleSheet.create({

    container: {
        flex: 1,});

AppRegistry.registerComponent('Demo',() => Demo);
定义方式和StackNavigator基本类似,不再赘述。

(2)HomeScreen界面和mineScreen界面:
  1. exportdefaultclassHomePageextendsComponent{
  2. staticnavigationoptions={
  3. drawerLabel:’首页’,
  4. drawerIcon:({tintColor})=>(
  5. <Image
  6. source={require(‘./../imgs/ic_happy.png’)}
  7. style={[styles.icon,{tintColor:tintColor}]}/>
  8. ),
  9. };
  10. render(){
  11. return(
  12. <Viewstyle={{flex:1}}>
  13. <TextonPress={this._skip.bind(this)}>点击跳转</Text>
  14. </View>
  15. );
  16. }
  17. _skip(){
  18. this.props.navigation.navigate(“mine”);
  19. }
  20. }
  21. exportdefaultclassminePageextendsComponent{
  22. staticnavigationoptions={
  23. drawerLabel:’我’,
  24. drawerIcon:({tintColor})=>(
  25. <Image
  26. source={require(‘./../imgs/ic_h.png’)}
  27. style={[styles.icon,{tintColor:tintColor}]}
  28. />
  29. ),
  30. };
  31. render(){
  32. return(
  33. <Viewstyle={{flex:1}}>
  34. <TextonPress={this._skip.bind(this)}>返回上一界面</Text>
  35. </View>
  36. );
  37. }
  38. /**
  39. *跳转
  40. */
  41. _skip(){
  42. this.props.navigation.goBack();
  43. }
  44. }
export default class HomePage extends Component {

    static navigationoptions = {
        drawerLabel: '首页',drawerIcon:({tintColor}) => (
            <Image
                source={require('./../imgs/ic_happy.png')}
                style={[styles.icon,{tintColor: tintColor}]}/>
        ),};

    render() {
        return(
            <View style={{flex:1}}>
                <Text onPress={this._skip.bind(this)}>点击跳转</Text>
            </View>
        );
    }

    _skip() {
        this.props.navigation.navigate("mine");
    }
}


export default class minePage extends Component {

    static navigationoptions = {
        drawerLabel:'我',drawerIcon: ({ tintColor }) => (
            <Image
                source={require('./../imgs/ic_h.png')}
                style={[styles.icon,{tintColor: tintColor}]}
            />
        ),};

    render() {
        return(
            <View style={{flex:1}}>
                <Text onPress={this._skip.bind(this)}>返回上一界面</Text>
            </View>
        );
    }

    /**
     * 跳转
     */
    _skip() {
        this.props.navigation.goBack();
    }
}
代码很简单,实现了界面之间的跳转

2、扩展功能

(1)认DrawerView不可滚动。要实现可滚动视图,必须使用contentComponent自定义容器,如下所示:
  1. {
  2. drawerWidth:200,
  3. 抽屉位置:“对”
  4. contentComponent:props=><ScrollView><DrawerItems{…props}/></ScrollView>
  5. }
{
  drawerWidth:200,
  抽屉位置:“对”
  contentComponent:props => <ScrollView> <DrawerItems {... props} /> </ ScrollView>
}
(2)可以覆盖导航使用的认组件,使用DrawerItems自定义导航组件:
  1. import{DrawerItems}from‘react-navigation’;
  2. constCustomDrawerContentComponent=(props)=>(
  3. <Viewstyle={style.container}>
  4. <DrawerItems{…props}/>
  5. </View>
  6. );
import {DrawerItems} from 'react-navigation';

const CustomDrawerContentComponent = (props) => (
  <View style = {style.container}>
    <DrawerItems {... props} />
  </View>  
);
(3)嵌套抽屉导航
如果您嵌套DrawerNavigation,抽屉将显示在父导航下方。

四、自定义react-navigation


(1)适配顶部导航栏标题
测试中发现,在iphone上标题栏的标题为居中状态,而在Android上则是居左对齐。所以需要我们修改源码,进行适配。
【node_modules – react-navigation – src – views – Header.js】的326行代码处,修改为如下:
  1. title:{
  2. bottom:0,
  3. left:TITLE_OFFSET,
  4. right:TITLE_OFFSET,
  5. top:0,
  6. position:‘absolute’,
  7. alignItems:‘center’,
  8. }
 title: {
    bottom: 0,left: TITLE_OFFSET,right: TITLE_OFFSET,top: 0,position: 'absolute',alignItems: 'center',}

上面方法通过修改源码的方式其实略有弊端,毕竟扩展性不好。还有另外一种方式就是,在navigationoptions中设置headerTitleStyle的alignSelf为 ’ center ‘即可解决


(2)去除返回键文字显示

【node_modules – react-navigation – src – views – HeaderBackButton.js】的91行代码处,修改为如下即可。
  1. {Platform.OS===‘ios’&&
  2. title&&
  3. <Text
  4. onLayout={this._onTextLayout}
  5. style={[styles.title,{color:tintColor}]}
  6. numberOfLines={1}
  7. >
  8. {backButtonTitle}
  9. </Text>}
       {Platform.OS === 'ios' &&
            title &&
            <Text
              onLayout={this._onTextLayout}
              style={[styles.title,{ color: tintColor }]}
              numberOfLines={1}
            >
              {backButtonTitle}
            </Text>}

将上述代码删除即可。


(3)动态设置头部按钮事件:

当我们在头部设置左右按钮时,肯定避免不了要设置按钮的单击事件,但是此时会有一个问题,navigationoptions是被修饰为static类型的,所以我们在按钮的onPress的方法中不能直接通过this来调用Component中的方法。如何解决呢?在官方文档中,作者给出利用设置params的思想来动态设置头部标题。那么我们可以利用这种方式,将单击回调函数以参数的方式传递到params,然后在navigationoption中利用navigation来取出设置到onPress即可:

  1. componentDidMount(){
  2. /**
  3. *将单击回调函数作为参数传递
  4. */
  5. this.props.navigation.setParams({
  6. switch:()=>this.switchView()
  7. });
  8. }
    componentDidMount () {
        /**
         * 将单击回调函数作为参数传递
         */
        this.props.navigation.setParams({
                switch: () => this.switchView()
        });
    }
  1. /**
  2. *切换视图
  3. */
  4. switchView(){
  5. alert(‘切换’)
  6. }
    /**
     * 切换视图
     */
    switchView() {
        alert('切换')
    }
  1. staticnavigationoptions=({navigation,screenProps})=>({
  2. headerTitle:’企业服务’,
  3. headerTitleStyle:CommonStyles.headerTitleStyle,
  4. headerRight:(
  5. <NavigatorItemicon={Images.ic_navigator}onPress={()=>navigation.state.params.switch()}/>
  6. ),
  7. headerStyle:CommonStyles.headerStyle
  8. });
    static navigationoptions = ({navigation,screenProps}) => ({
        headerTitle: '企业服务',headerTitleStyle: CommonStyles.headerTitleStyle,headerRight: (
            <NavigatorItem icon={ Images.ic_navigator } onPress={ ()=> navigation.state.params.switch() }/>
        ),headerStyle: CommonStyles.headerStyle
    });

(4)结合BackHandler处理返回和点击返回键两次退出App效果

点击返回键两次退出App效果的需求屡见不鲜。相信很多人在react-navigation下实现该功能都遇到了很多问题,例如,其他界面不能返回。也就是手机本身返回事件在react-navigation之前拦截了。如何结合react-natigation实现呢?和大家分享两种实现方式:

(1)在注册StackNavigator的界面中,注册BackHandler:

  1. componentwillMount(){
  2. BackHandler.addEventListener(’hardwareBackPress’,this._onBackAndroid);
  3. }
  4. componentUnWillMount(){
  5. BackHandler.addEventListener(’hardwareBackPress’,this._onBackAndroid);
  6. }
  7. _onBackAndroid=()=>{
  8. letNow=newDate().getTime();
  9. if(Now-lastBackpressed<2500){
  10. returnfalse;
  11. }
  12. lastBackpressed=Now;
  13. ToastAndroid.show(’再点击一次退出应用,ToastAndroid.SHORT);
  14. returntrue;
  15. }
    componentwillMount(){
        BackHandler.addEventListener('hardwareBackPress',this._onBackAndroid );
    }


    componentUnWillMount(){
        BackHandler.addEventListener('hardwareBackPress',this._onBackAndroid);
    }

    _onBackAndroid=()=>{
        let Now = new Date().getTime();
        if(Now - lastBackpressed < 2500) {
            return false;
        }
        lastBackpressed = Now;
        ToastAndroid.show('再点击一次退出应用',ToastAndroid.SHORT);
        return true;
    }

(2)监听react-navigation的Router
  1. /**
  2. *处理安卓返回键
  3. */
  4. constdefaultStateAction=AppNavigator.router.getStateForAction;
  5. AppNavigator.router.getStateForAction=(action,state)=>{
  6. if(state&&action.type===NavigationActions.BACK&&state.routes.length===1){
  7. if(lastBackpressed+2000<Date.Now()){
  8. ToastAndroid.show(Constant.hint_exit,ToastAndroid.SHORT);
  9. lastBackpressed=Date.Now();
  10. constroutes=[…state.routes];
  11. return{
  12. …state,
  13. …state.routes,
  14. index:routes.length-1,
  15. };
  16. }
  17. }
  18. returndefaultStateAction(action,state);
  19. };
/**
 * 处理安卓返回键
 */
const defaultStateAction = AppNavigator.router.getStateForAction;
AppNavigator.router.getStateForAction = (action,state) => {
    if(state && action.type === NavigationActions.BACK && state.routes.length === 1) {
        if (lastBackpressed + 2000 < Date.Now()) {
            ToastAndroid.show(Constant.hint_exit,ToastAndroid.SHORT);
            lastBackpressed = Date.Now();
            const routes = [...state.routes];
            return {
                ...state,...state.routes,index: routes.length - 1,};
        }
    }
    return defaultStateAction(action,state);
};

(5)实现Android中界面跳转左右切换动画

react-navigation在android认的界面切换动画是上下。如何实现左右切换呢?很简单的配置即可:

  1. importCardStackStyleInterpolatorfrom‘react-navigation/src/views/CardStackStyleInterpolator’;
import CardStackStyleInterpolator from 'react-navigation/src/views/CardStackStyleInterpolator';
然后在StackNavigator的配置下添加如下代码
  1. transitionConfig:()=>({
  2. screenInterpolator:CardStackStyleInterpolator.forHorizontal,
  3. })
        transitionConfig:()=>({
            screenInterpolator: CardStackStyleInterpolator.forHorizontal,})

(6)解决快速点击多次跳转

当我们快速点击跳转时,会开启多个重复的界面,如何解决呢。其实在官方Git中也有提示解决这个问题需要修改react-navigation源码:

找到scr文件夹中的addNavigationHelpers.js文件,替换为如下文本即可:

  1. exportdefaultfunction<S:*>(navigation:NavigationProp<S,NavigationAction>){
  2. //添加点击判断
  3. letdebounce=true;
  4. return{
  5. …navigation,
  6. goBack:(key?:?string):boolean=>
  7. navigation.dispatch(
  8. NavigationActions.back({
  9. key:key===undefined?navigation.state.key:key,
  10. }),
  11. ),
  12. navigate:(routeName:string,
  13. params?:NavigationParams,
  14. action?:NavigationAction,):boolean=>{
  15. if(debounce){
  16. debounce=false;
  17. navigation.dispatch(
  18. NavigationActions.navigate({
  19. routeName,
  20. params,
  21. action,
  22. );
  23. setTimeout(
  24. ()=>{
  25. debounce=true;
  26. },
  27. 500,
  28. );
  29. returntrue;
  30. }
  31. returnfalse;
  32. },
  33. /**
  34. *Forupdatingcurrentrouteparams.Forexamplethenavbartitleand
  35. *buttonsarebasedontherouteparams.
  36. *Thismeans`setParams`canbeusedtoupdatenavbarforexample.
  37. */
  38. setParams:(params:NavigationParams):boolean=>
  39. navigation.dispatch(
  40. NavigationActions.setParams({
  41. params,
  42. key:navigation.state.key,
  43. };
  44. }
export default function<S: *>(navigation: NavigationProp<S,NavigationAction>) {
  // 添加点击判断
  let debounce = true;
  return {
      ...navigation,goBack: (key?: ?string): boolean =>
          navigation.dispatch(
              NavigationActions.back({
                  key: key === undefined ? navigation.state.key : key,}),),navigate: (routeName: string,params?: NavigationParams,action?: NavigationAction,): boolean => {
          if (debounce) {
              debounce = false;
              navigation.dispatch(
                  NavigationActions.navigate({
                      routeName,params,action,);
              setTimeout(
                  () => {
                      debounce = true;
                  },500,);
              return true;
          }
          return false;
      },/**
     * For updating current route params. For example the nav bar title and
     * buttons are based on the route params.
     * This means `setParams` can be used to update nav bar for example.
     */
    setParams: (params: NavigationParams): boolean =>
      navigation.dispatch(
        NavigationActions.setParams({
          params,key: navigation.state.key,};
}


五、效果


抽屉导航:



以上就是我们实战中常用的属性和技巧。具体的操作还需要大家在实践过程中测试体会。

源码参考

相关文章

一、前言 在组件方面react和Vue一样的,核心思想玩的就是组件...
前言: 前段时间学习完react后,刚好就接到公司一个react项目...
前言: 最近收到组长通知我们项目组后面新开的项目准备统一技...
react 中的高阶组件主要是对于 hooks 之前的类组件来说的,如...
我们上一节了解了组件的更新机制,但是只是停留在表层上,例...
我们上一节了解了 react 的虚拟 dom 的格式,如何把虚拟 dom...