【react-native】react-navigation使用技巧

前端之家收集整理的这篇文章主要介绍了【react-native】react-navigation使用技巧前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

一,开源介绍

今年1月份,新开源的React-natvigation库备受瞩目。在短短不到3个月的时间,github上星数已达4000+。Fb推荐使用库,并且在React Native当前最新版本0.44中将Navigator删除。react-navigation据称有原生般的性能体验效果。可能会成为未来React Native导航组件的主流军。本篇内容基于【 ^1.0.0-beta.9】版本来介绍关于该库的使用和实战技巧。可以看到,虽然是beta版本,不过基本稳定,大家可放心在项目中使用。该库包含三类组件:
(1)StackNavigator:用来@R_465_404@面和传递参数
(2)TabNavigator:类似底部导航栏,用来在同一屏幕下切换不同界面
(3)DrawerNavigator:侧滑菜单导航栏,用于轻松设置带抽屉导航的屏幕

二,react-navigation使用

具体内容大致分为如下:
(1)react-navigation库属性介绍
(2)StackNavigator、TabNavigator实现界面间跳转,Tab切换
(3)StackNavigator界面间跳转、传值、取值
(4)DrawerNavigator实现抽屉导航菜单
(5)DrawerNavigator扩展功能
(6)修改源码,定制UI界面

1、StackNavigator属性介绍

  1. navigationOptions:配置StackNavigator的一些属性
  2. title标题,如果设置了这个导航栏和标签栏的title就会变成一样的,不推荐使用
  3. header:可以设置一些导航的属性,如果隐藏顶部导航栏只要将这个属性设置为null
  4. headerTitle:设置导航栏标题,推荐
  5. headerBackTitle:设置@R_465_404@面左侧返回箭头后面的文字,默认是上一个页面标题。可以自定义,也可以设置为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. modaliOS独有的使屏幕从底部画出。类似iOSpresent效果
  19. headerMode:返回上级页面时动画效果
  20. floatiOS默认的效果
  21. screen:滑动过程中,整个页面都会返回
  22. none:无动画
  23. cardStyle自定义设置跳转效果
  24. transitionConfig 自定义设置滑动返回的配置
  25. onTransitionStart:当转换动画即将开始时被调用功能
  26. onTransitionEnd:当转换动画完成,将被调用功能
  27. path:路由中设置的路径的覆盖映射配置
  28. initialRouteName:设置默认的页面组件,必须是上面已注册页面组件
  29. 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. activeTintColorlabelicon的前景色 活跃状态下
  16. activeBackgroundColorlabelicon的背景色 活跃状态下
  17. inactiveTintColorlabelicon的前景色 不活跃状态下
  18. inactiveBackgroundColorlabelicon的背景色 不活跃状态下
  19. showLabel:是否显示label,默认开启 styletabbar的样式
  20. labelStylelabel的样式安卓属性
  21. activeTintColorlabelicon的前景色 活跃状态下
  22. inactiveTintColorlabelicon的前景色 不活跃状态下
  23. showIcon:是否显示图标,默认关闭
  24. showLabel:是否显示label,默认开启 styletabbar的样式
  25. labelStylelabel的样式 upperCaseLabel:是否使标签大写,默认为true
  26. pressColormaterial涟漪效果的颜色(安卓版本需要大于5.0
  27. pressOpacity:按压标签的透明度变化(安卓版本需要小于5.0
  28. scrollEnabled:是否启用可滚动选项卡 tabStyletab的样式
  29. indicatorStyle标签指示器的样式对象(选项卡底部的行)。安卓底部会多出一条线,可以将height设置为0来暂时解决这个问题
  30. labelStylelabel的样式
  31. 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. DrawerItemscontentOptions属性
  11. activeTintColor - 活动标签标签和图标颜色
  12. activeBackgroundColor - 活动标签的背景颜色
  13. inactiveTintColor - 非活动标签标签和图标颜色
  14. inactiveBackgroundColor - 非活动标签的背景颜色内容部分的样式样式对象
  15. 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. import HomeScreen from './pages/HomePage';
  3. import MineScreen from './pages/MinePage';

(3)定义TabNavigator:

  1. const Tab = TabNavigator(
  2. {
  3. Home:{
  4. screen:HomeScreen,navigationOptions:({navigation}) => ({
  5. tabBarLabel:'首页',tabBarIcon:({focused,tintColor}) => (
  6. <TabBarItem
  7. tintColor={tintColor}
  8. focused={focused}
  9. normalImage={require('./imgs/nav_fav@2x.png')}
  10. selectedImage={require('./imgs/nav_fav_actived@3x.png')}
  11. />
  12. )
  13. }),},Mine:{
  14. screen:MineScreen,navigationOptions:({navigation}) => ({
  15. tabBarLabel:'我',tintColor}) => (
  16. <TabBarItem
  17. tintColor={tintColor}
  18. focused={focused}
  19. normalImage={require('./imgs/tab_me_nor@3x.png')}
  20. selectedImage={require('./imgs/tab_me_selected@2x.png')}
  21. />
  22. )
  23. }),{
  24. tabBarComponent:TabBarBottom,tabBarPosition:'bottom',swipeEnabled:false,animationEnabled:false,lazy:true,tabBarOptions:{
  25. activeTintColor:'#06c1ae',inactiveTintColor:'#979797',style:{backgroundColor:'#ffffff',labelStyle: {
  26. fontSize: 20,// 文字大小
  27. },}
  28. }
  29. );

TabBarItem为封装的组件:

  1. import React,{Component} from 'react';
  2. import {Image} from 'react-native';
  3. export default class TabBarItem extends Component {
  4. render() {
  5. return(
  6. <Image source={ this.props.focused ? this.props.selectedImage : this.props.normalImage }
  7. style={ { tintColor:this.props.tintColor,width:25,height:25 } }
  8. />
  9. )
  10. }
  11. }

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

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

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

TabNavigator定义好之后,需要用StackNavigator,顾名思义,StackNavigator就是以栈的方式来存放整个界面的,而TabNavigator是作为一个界面内不同子界面之间切换。所以还需要我们定义StackNavigator:

  1. const Navigator = StackNavigator(
  2. {
  3. Tab:{screen:Tab},Product:{screen:ProductScreen}
  4. },{
  5. navigationOptions:{
  6. headerBackTitle:null,headerTintColor:'#333333',showIcon:true,mode:'card',});

看起来和TabNavigator很相似,同样是指定了两个参数:

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

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

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

最后就是在render中引用StackNavigator:

  1. export default class Demo extends Component {
  2. render() {
  3. return (
  4. <Navigator />
  5. );
  6. }
  7. }

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

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

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

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

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

  1. this.props.navigation.navigate('Mine');

参数为我们在StackNavigator注册界面组件时的名称。同样也可以从当前页面返回到上一页

  1. // 返回上一页
  2. this.props.navigation.goBack();

(2)跳转时传值:

  1. this.props.navigation.navigate('Mine',{info:'传值过去'});

第一个参数同样为要跳转的界面组件名称,第二个参数为要传递的参数,info可以理解为key,后面即传递的参数。

(3)获取值:

  1. {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. import HomeScreen from './pages/HomePage';
  3. import MineScreen from './pages/MinePage';
  4. export default class Demo extends Component {
  5. render() {
  6. return (
  7. <Navigator />
  8. );
  9. }
  10. }
  11. const Navigator = DrawerNavigator({
  12. Home:{screen:HomeScreen},Mine:{screen:MineScreen},});
  13. const styles = StyleSheet.create({
  14. container: {
  15. flex: 1,});
  16. AppRegistry.registerComponent('Demo',() => Demo);

定义方式和StackNavigator基本类似,不再赘述。

(2)HomeScreen界面和MineScreen界面:

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

代码很简单,实现了界面之间的跳转

2、扩展功能

(1)默认DrawerView不可滚动。要实现可滚动视图,必须使用contentComponent自定义容器,如下所示:

  1. {
  2. drawerWidth200
  3. 抽屉位置:“对”
  4. contentComponentprops => <ScrollView> <DrawerItems {... props} /> </ ScrollView>
  5. }

(2)可以覆盖导航使用的默认组件,使用DrawerItems自定义导航组件:

  1. import {DrawerItems} from 'react-navigation';
  2. const CustomDrawerContentComponent = (props) => (
  3. <View style = {style.container}>
  4. <DrawerItems {... props} />
  5. </View>
  6. );

(3)嵌套抽屉导航
如果您嵌套DrawerNavigation,抽屉将显示在父导航下方。

四、react-navigation源码定制

(1)适配顶部导航栏标题

测试中发现,在iphone上标题栏的标题为居中状态,而在Android上则是居左对齐。所以需要我们修改源码,进行适配。

【node_modules -- react-navigation -- src -- views -- Header.js】的326行代码处,修改为如下:

  1. title: {
  2. bottom: 0,left: TITLE_OFFSET,right: TITLE_OFFSET,top: 0,position: 'absolute',alignItems: '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>}

将上述代码删除即可。

(3)设置标题栏的按钮单击事件:

因为在界面组件中设置标题参数时,需要将navigationOptions定义成static。所以我们不能直接通过this.xxx.bind(this)来调用自定义函数,怎么办呢?可以通过如何方式解决

  1. class demo extends Component {
  2. static navigationOptions =({navigation})=>({
  3. right:( <Button onPress={state.params.clickParams}/>)
  4. })
  5. _btnClick=()=> {
  6. alert('单击')
  7. };
  8. componentWillMount() {
  9. this.props.navigation.setParams({clickParams:this._btnClick})
  10. }
  11. }

(4)动态设置标题显示和隐藏

根据(3)中的思想,我们可以利用setParams来动态修改状态栏的显示和隐藏:

  1. class demo extends Component {
  2. static navigationOptions = ({navigation}) =>({
  3. visible: state.params.headerState,});
  4. render(){
  5. return(
  6. <Button
  7. title="Hide Header"
  8. onPress={() => this.props.navigation.setParams({ headerState : 'none' })}
  9. />)
  10. }
  11. }

五、效果

。。。。

猜你在找的React相关文章