该库包含三类组件:
(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 3 title:标题,如果设置了这个导航栏和标签栏的title就会变成一样的,不推荐使用 4 header:可以设置一些导航的属性,如果隐藏顶部导航栏只要将这个属性设置为null 5 headerTitle:设置导航栏标题,推荐 6 headerBackTitle:设置跳转页面左侧返回箭头后面的文字,默认是上一个页面的标题。可以自定义,也可以设置为null 7 headerTruncatedBackTitle:设置当上个页面标题不符合返回箭头后的文字时,默认改成"返回" 8 headerRight:设置导航条右侧。可以是按钮或者其他视图控件 9 headerLeft:设置导航条左侧。可以是按钮或者其他视图控件 10 headerStyle:设置导航条的样式。背景色,宽高等 11 headerTitleStyle:设置导航栏文字样式 12 headerBackTitleStyle:设置导航栏‘返回’文字样式 13 headerTintColor:设置导航栏颜色 14 headerPressColorAndroid:安卓独有的设置颜色纹理,需要安卓版本大于5.0 15 gesturesEnabled:是否支持滑动返回手势,iOS默认支持,安卓默认关闭 16 17 18 screen:对应界面名称,需要填入import之后的页面 19 20 mode:定义跳转风格 21 22 card:使用iOS和安卓默认的风格 23 24 modal:iOS独有的使屏幕从底部画出。类似iOS的present效果 25 26 headerMode:返回上级页面时动画效果 27 28 float:iOS默认的效果 29 30 screen:滑动过程中,整个页面都会返回 31 32 none:无动画 33 34 cardStyle:自定义设置跳转效果 35 36 transitionConfig: 自定义设置滑动返回的配置 37 38 onTransitionStart:当转换动画即将开始时被调用的功能 39 40 onTransitionEnd:当转换动画完成,将被调用的功能 41 42 path:路由中设置的路径的覆盖映射配置 43 44 initialRouteName:设置默认的页面组件,必须是上面已注册的页面组件 45 46 initialRouteParams:初始路由参数
注:大家可能对于path不太理解。path属性适用于其他app或浏览器使用url打开本app并进入指定页面。path属性用于声明一个界面路径,例如:【/pages/Home】。此时我们可以在手机浏览器中输入:app名称://pages/Home来启动该App,并进入Home界面。
2、TabNavigator属性介绍
1 screen:和导航的功能是一样的,对应界面名称,可以在其他页面通过这个screen传值和跳转。 2 3 4 navigationOptions:配置TabNavigator的一些属性 5 6 title:标题,会同时设置导航条和标签栏的title 7 8 tabBarVisible:是否隐藏标签栏。默认不隐藏(true) 9 10 tabBarIcon:设置标签栏的图标。需要给每个都设置 11 12 tabBarLabel:设置标签栏的title。推荐 13 14 导航栏配置 15 16 tabBarPosition:设置tabbar的位置,iOS默认在底部,安卓默认在顶部。(属性值:'top','bottom') 17 18 swipeEnabled:是否允许在标签之间进行滑动 19 20 animationEnabled:是否在更改标签时显示动画 21 22 lazy:是否根据需要懒惰呈现标签,而不是提前,意思是在app打开的时候将底部标签栏全部加载,默认false,推荐为true 23 24 trueinitialRouteName: 设置默认的页面组件 25 26 backBehavior:按 back 键是否跳转到第一个Tab(首页), none 为不跳转 27 28 tabBarOptions:配置标签栏的一些属性iOS属性 29 30 activeTintColor:label和icon的前景色 活跃状态下 31 32 activeBackgroundColor:label和icon的背景色 活跃状态下 33 34 inactiveTintColor:label和icon的前景色 不活跃状态下 35 36 inactiveBackgroundColor:label和icon的背景色 不活跃状态下 37 38 showLabel:是否显示label,默认开启 style:tabbar的样式 39 40 labelStyle:label的样式安卓属性 41 42 activeTintColor:label和icon的前景色 活跃状态下 43 44 inactiveTintColor:label和icon的前景色 不活跃状态下 45 46 showIcon:是否显示图标,默认关闭 47 48 showLabel:是否显示label,默认开启 style:tabbar的样式 49 50 labelStyle:label的样式 upperCaseLabel:是否使标签大写,默认为true 51 52 pressColor:material涟漪效果的颜色(安卓版本需要大于5.0) 53 54 pressOpacity:按压标签的透明度变化(安卓版本需要小于5.0) 55 56 scrollEnabled:是否启用可滚动选项卡 tabStyle:tab的样式 57 58 indicatorStyle:标签指示器的样式对象(选项卡底部的行)。安卓底部会多出一条线,可以将height设置为0来暂时解决这个问题 59 60 labelStyle:label的样式 61 62 iconStyle:图标样式
3、DrawerNavigator属性介绍
1 const Tab = 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 18 Mine:{ 19 screen:MineScreen, 20 navigationOptions:({navigation}) => ({ 21 tabBarLabel:'我', 22 tabBarIcon:({focused,tintColor}) => ( 23 <TabBarItem 24 tintColor={tintColor} 25 focused={focused} 26 normalImage={require('./imgs/tab_me_nor@3x.png')} 27 selectedImage={require('./imgs/tab_me_selected@2x.png')} 28 /> 29 ) 30 }), 31 }, 32 }, 33 34 { 35 tabBarComponent:TabBarBottom, 36 tabBarPosition:'bottom', 37 swipeEnabled:false, 38 animationEnabled:false, 39 lazy:true, 40 tabBarOptions:{ 41 activeTintColor:'#06c1ae', 42 inactiveTintColor:'#979797', 43 style:{backgroundColor:'#ffffff',}, 44 labelStyle: { 45 fontSize: 20, // 文字大小 46 }, 47 } 48 49 } 50 51 );
TabBarItem为封装的组件:
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,25,height:25 } } /> ) } }
可以看到,我们定义了一个名称为【Tab】的TabNavigator的导航组件。在组件中,分为两层参数:
(1)第一层参数定义了要切换的界面,即【首页】、【我】两个界面组件,通过screen属性指定。并且通过navigationOptions属性设置相关属性参数。
(2)设置导航栏的属性参数。
TabNavigator定义好之后,需要用StackNavigator,顾名思义,StackNavigator就是以栈的方式来存放整个界面的,而TabNavigator是作为一个界面内不同子界面之间切换。所以还需要我们定义StackNavigator:
1 const Navigator = StackNavigator( 2 3 { 4 Tab:{screen:Tab}, 5 Product:{screen:ProductScreen} 6 }, 7 8 { 9 navigationOptions:{ 10 headerBackTitle:null, 11 headerTintColor:'#333333', 12 showIcon:true, 13 swipeEnabled:false, 14 animationEnabled:false, 15 }, 16 17 mode:'card', 18 });
看起来和TabNavigator很相似,同样是指定了两个参数:
(1)指定要跳转的界面组件。同样是screen属性标识界面组件,不多赘述。
(2)定义跳转属性参数,即顶部导航栏的一些参数设置和跳转方式。
可以看到,我们将Tab作为一个界面设置到了StackNavigator。这样就可以实现Tab导航和界面间跳转的效果了。
最后就是在render中引用StackNavigator:
export default class Demo extends Component { render() { return ( <Navigator /> ); } }
5、界面间跳转、传值、取值
在界面组件注入到StackNavigator中时,界面组件就被赋予了navigation属性,即在界面组件中可以通过【this.props.navigation】获取并进行一些操作。
navigation属性中提供了很多的函数简化界面间操作,简单列举几点:
(1)通过navigate函数实现界面之间跳转:
this.props.navigation.navigate('Mine');
参数为我们在StackNavigator注册界面组件时的名称。同样也可以从当前页面返回到上一页:
1 // 返回上一页 2 this.props.navigation.goBack();
(2)跳转时传值:
this.props.navigation.navigate('Mine',{info:'传值过去'});
第一个参数同样为要跳转的界面组件名称,第二个参数为要传递的参数,info可以理解为key,后面即传递的参数。
(3)获取值:
{this.props.navigation.state.params.info}
通过state.params来获取传来的参数,后面为key值。此处为info。
以上实现完成,我们就可以愉快的玩耍啦~~ 什么?忽然发现在Android上的效果和IOS效果不一样。老板要界面一致哇~ 怎么办?那就需要我们进行简单的适配了。
三、DrawerNavigator实现抽屉导航
1、导航实现
API定义:DrawerNavigator(RouteConfigs,DrawerNavigatorConfig)
(1)界面中定义DrawerNavigator:
1 import {StackNavigator,TabNavigator,DrawerNavigator} from 'react-navigation'; 2 import HomeScreen from './pages/HomePage'; 3 import MineScreen from './pages/MinePage'; 4 5 export default class Demo extends Component { 6 7 render() { 8 return ( 9 <Navigator /> 10 ); 11 } 12 } 13 14 const Navigator = DrawerNavigator({ 15 16 Home:{screen:HomeScreen}, 17 Mine:{screen:MineScreen}, 18 }); 19 20 const styles = StyleSheet.create({ 21 22 container: { 23 flex: 1, 24 }, 25 }); 26 27 AppRegistry.registerComponent('Demo', () => Demo);
定义方式和StackNavigator基本类似,不再赘述。
(2)HomeScreen界面和MineScreen界面:
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自定义容器,如下所示:
{ drawerWidth:200, 抽屉位置:“对” contentComponent:props => <ScrollView> <DrawerItems {... props} /> </ ScrollView> }
(2)可以覆盖导航使用的默认组件,使用DrawerItems自定义导航组件:
import {DrawerItems} from 'react-navigation'; const CustomDrawerContentComponent = (props) => ( <View style = {style.container}> <DrawerItems {... props} /> </View> );
(3)嵌套抽屉导航
如果您嵌套DrawerNavigation,抽屉将显示在父导航下方。