一、介绍
导航组件Navigator可以让我们客户端在不同的页面见进行切换。为了达到这样的功能,Navigator提供了路由对象功能进行区分识别每一个页面。同时我们可以通过renderScene方法,Navaigator根据指定的路由进行渲染指定的界面。
支持:ios,android
二、属性
-
configureScene function 方法,该为可选的方法进行配置页面切换动画和手势。该会通过路由和路由栈两个参数调用,进行返回一个页面参数配置对象:(route,routeStack) => Navigator.SceneConfigs.FloatFromRight
-
initialRoute object 参数对象 进行设置导航初始化的路由页面。路由是标识导航器渲染标识每一个页面的对象。initialRoute必须为initialRouteStack中的路 由。同时initialRoute默认为initialRouteStack中路由栈的最后一项
-
initialRouteStack [object] 参数对象数组 该是一个初始化的路由数组进行初始化。如果initalRoute属性没有设置的话,那么就必须设置initialRouteStack属性,使用该最后 一项作为初始路由。 如果initalRouteStack属性没有设置的话,该会生成只包含initalRoute值的数组
-
navigationBar node 该为可选的参数,在页面切换中用来提供一个导航栏
-
onDidFoucs function 该方法已经废弃,我们可以使用navigationContext.addListener('didfocus',callback)方法进行替代。该 会在每次页面切换完成或者初始化之后进行调用该方法。该参数为新页面的路由
-
onWillFocus function 该方法已经废弃,我们可以使用navigationContext.addListener('willfocus',callback)方法进行替代。该会页面每次进行切换之前调用
-
renderScene function 该为必须调用的方法,该用来渲染每一个路由指定的页面。参数为路由以及导航器对象两个参数,具体是方法如下:(route,navigator) =><MySceneComponent title={route.title} navigator={navigator} />
-
sceneStyle 样式风格,该继承了View视图的所有样式风格。可以参照:点击查看View样式。 该设置用于每个页面容器的风格
红色的三个是主要方法
三、页面跳转效果
为了改变页面切换的动画或者页面的手势,该组件提供的configureScene属性来进行获取指定路由页面的配置对象信息。对于页面切换动画或者更多的屏幕配置选项信息详情可以查看Navigator.SceneConfigs
关于动画手势有如下一些属性:
更多属性大家可以进行修改NavigatorSceneConfigs.js该文件即可
-
-
PushFromRight
-
FloatFromRight
-
FloatFromLeft
-
FloatFromBottom
-
FloatFromBottomAndroid
-
FadeAndroid
-
HorizontalSwipeJump
-
HorizontalSwipeJumpFromRight
-
VerticalUpSwipeJump
-
VerticalDownSwipeJump
-
四、页面跳转方法
-
getCurrentRoutes() 该进行返回存在的路由列表信息
-
resetTo(route) 进行导航到新的界面,并且重置整个路由栈
-
immediatelyResetRouteStack(routeStack) 该通过一个路由页面数组来进行重置路由栈
说明
1、一个有意思的事情是,如果你的动画是从右边往左进入的,你从左往右滑动,可以回到前一个路由页面
如果想去掉手势返回可以这儿样写
<Navigator initialRoute={{params:{name:'Home页面',age:14},component:Home}} configureScene={(route) => { if (route.sceneConfig) { let res=route.sceneConfig; res.gestures=null; return res; //return route.sceneConfig; } return Navigator.SceneConfigs.FloatFromBottom; }} renderScene={(route,navigator) =>{ let DefaultComponent=route.component; let number=12; return <DefaultComponent number={number} {...route.params} navigator={navigator}/> } } />
2、这些方法要合理使用才能够达到最佳效果,比如筛选页面就应该弹出一个新页面而不把之前的页面卸载。
这些都是navigator可以用的public method,就是跳转用的,里面有些带参数的XXX(route),新手第一次看这个文档会疑惑,这个route参数是啥呢,这个route就是Navigator组件属性的initialRoute,是一个对象。
解惑
我最开始不理解他是怎么设置的,所以每次都会是渲染相同的页面,切换页面的效果也一样,如果所示
classRockqextendsComponent{ render(){ return( <Navigator initialRoute={{name:'Home页面',index:0}} configureScene={(route)=>{ //渲染的动画是固定的了 returnNavigator.SceneConfigs.VerticalDownSwipeJump; }} renderScene={(route,navigator)=>{ constnumber=12; //渲染的组件是固定的了 return<Homenumber={number}{...route}navigator={navigator}/> } } /> ); } }
疑问
1、一个应用中只需要一个Navigator吗?
导航组件中有这么一个属性(navigator object 该为可选参数,可以从父类导航器中获取导航器对象),所以我猜测Navigator可以嵌套,但最好用一个navigator,其实平常我们在根组件上用一个Navigator就可以了。
2、导航组件里面的栈的概念?
正是因为有了栈,才可以实现返回前进的操作。
时间不够,待完善。
4、navigationBar属性
这个组件我用了一下,就是在你手机屏幕的最下面展示你给的组件,弄不明白干什么用的,好像没什么大用,回头弄清楚了了再给完善进来。
5、组件上onDidFoucs onWillFocus 两个废弃的方法怎么使用
在组件中使用,但是你在用的时候就会发现从page1跳转到home页面的时候,page1中和home中的事件都触发了,可能因为在组件离开的时候忘了取消了,这是react中监听事件的问题。
componentWillMount(){ this.props.navigator.navigationContext.addListener('willfocus',()=>Alert.alert( 'AlertTitle',`将要进入路由${this.props.name}` )); this.props.navigator.navigationContext.addListener('didfocus',`进入路由${this.props.name}` )); }
换行
componentWillUnmount(){ this.props.navigator.navigationContext.removeListener('willfocus',`将要进入路由${this.props.name}` )); this.props.navigator.navigationContext.removeListener('didfocus',`进入路由${this.props.name}` )); }
重要思考:
后来我又想了一下,发现不对,都是同一个navigator对象,不用添加那么多次所以这个方法可以加载组件的生命周期中,也可以加载Navigator组件中的renderScene方法中。
参考文章
http://reactnative.cn/docs/0.24/navigator.html#content
免责说明
1、本博客中的文章摘自网上的众多博客,仅作为自己知识的补充和整理,并分享给其他需要的coder,不会用于商用。
2、因为很多博客的地址看完没有及时做保存,所以很多不会在这里标明出处,非常感谢各位大牛的分享,也希望大家理解。
完整代码
项目结构
1、App.js代码
importReact,{ AppRegistry,Component,StyleSheet,Text,View,Navigator }from'react-native'; importHomefrom'./Home'; exportdefaultclassAppextendsComponent{ render(){ return( <Navigator initialRoute={{params:{name:'Home页面'},component:Home}} configureScene={(route)=>{ if(route.sceneConfig){ returnroute.sceneConfig; } returnNavigator.SceneConfigs.FloatFromBottom; }} renderScene={(route,navigator)=>{ letDefaultComponent=route.component; letnumber=12; return<DefaultComponentnumber={number}{...route.params}navigator={navigator}/> } } /> ); } } conststyles=StyleSheet.create({ });
关键就在于configureScene中的动画不要写死,renderScene中渲染的组件不要写死
2、Home.js
importReact,TouchableHighlight,Navigator }from'react-native'; importPage1from'./Page1'; importPage2from'./Page2'; importPage3from'./Page3'; exportdefaultclassHomeextendsComponent{ render(){ return( <Viewstyle={styles.container}> <Textstyle={styles.title}> {this.props.name} </Text> <TouchableHighlight onPress={()=>this.props.navigator.push({ sceneConfig:Navigator.SceneConfigs.FloatFromRight,component:Page1,params:{ name:'Page1页面' } }) }> <Textstyle={[styles.page1,styles.text]}> 跳转到Page1 </Text> </TouchableHighlight> <TouchableHighlight onPress={()=>this.props.navigator.push({ sceneConfig:Navigator.SceneConfigs.FloatFromBottom,component:Page2,params:{ name:'Page2页面' } }) }> <Textstyle={[styles.page2,styles.text]}> 跳转到Page2 </Text> </TouchableHighlight> <TouchableHighlight onPress={()=>this.props.navigator.push({ sceneConfig:Navigator.SceneConfigs.HorizontalSwipeJumpFromRight,component:Page3,params:{ name:'Page3页面' } }) }> <Textstyle={[styles.page3,styles.text]}> 跳转到Page3 </Text> </TouchableHighlight> </View> ); } } conststyles=StyleSheet.create({ container:{ flex:1,justifyContent:'center',alignItems:'center',backgroundColor:'#F5FCFF',},title:{ fontSize:60 },text:{ textAlign:'center',color:'#333333',marginBottom:5,page1:{ fontSize:40,backgroundColor:'red' },page2:{ fontSize:40,backgroundColor:'blue' },page3:{ fontSize:40,backgroundColor:'yellow' },});
3、Page1.js
importReact,Navigator }from'react-native'; importPage2from'./Page2'; exportdefaultclassPage1extendsComponent{ render(){ return( <Viewstyle={styles.container}> <Textstyle={styles.title}> {this.props.name} </Text> <TouchableHighlight onPress={()=>this.props.navigator.push({ sceneConfig:Navigator.SceneConfigs.FloatFromRight,params:{ name:'Page2页面' } }) }> <Textstyle={[styles.text]}> 跳转到Page2 </Text> </TouchableHighlight> <TouchableHighlight onPress={()=>this.props.navigator.pop() }> <Textstyle={[styles.text]}> 返回 </Text> </TouchableHighlight> </View> ); } } conststyles=StyleSheet.create({ container:{ flex:1,backgroundColor:'#00ced1',fontSize:40,} });