Navigator
- 简单介绍：
- 大多数时候我们都需要导航器来应对不同场景（页面）间的切换。它通过路由对象来分辨不同的场景，我们这里采用的就是
renderScene 方法，根据指定的路由来渲染。
- 利用Navigator弹出用到的方法
- 指定了默认的页面，也就是启动的组件页面
initialRoute = {{ name: 'home', component: HomeScene }}
configureScene = {() => {
return Navigator.SceneConfigs.HorizontalSwipeJump;
}}
node_modules/react-native/Libraries/CustomComponents/Navigator/NavigatorSceneConfigs.js
-
renderScene ：两个参数中的route包含的事initial的时候传递的name和component，而navigator是一个我们需要用的Navigator的对象，所以当我们拿到route中的component的时候，我们就可以将navigator传递给它，正因为如此，我们的组件HomeScene才可以通过 this.props.navigator，拿到路由。
- 如果需要传参数，则在push的参数后面加多一个参数
params，把JSON往死填就好了，这里的params，其实就是在renderScene中return的{...route.params},这样接收的页面只需要通过this.props.id，就可以拿到我们传递的参数
- OK，那参数怎么回传呢？
回调！通过定义一个回调函数，利用this.props 去调用，把参数回传回来
- 完整代码
/**
* Sample React Native App
* https://github.com/facebook/react-native
*/
'use strict';
var React = require('react-native');
//增加NavigatorIOS
var {
AppRegistry,
StyleSheet,
Text,
View,
Navigator,
TouchableHighlight,
} = React;
/*-- 启动组件 --*/
var MainClass = React.createClass({
render: function() {
//component这里设置的是这个组件启动的时候显示的第一个子组件
return (
<Navigator
style= {styles.container}
initialRoute= {{
component: HomeScene,
name: 'home'
}}
configureScene={() => {
return Navigator.SceneConfigs.HorizontalSwipeJump;
}}
renderScene={(route, navigator) => {
let Component = route.component;
if(route.component) {
return <Component {...route.params} navigator={navigator} />
}
}} >
</Navigator>
);
},
});
/*-- 首页页面组件 --*/
var HomeScene = React.createClass({
getInitialState:function () {
return {
id: 'AXIBA001',
flag: null
};
},
render: function() {
return (
<View style={styles.home}>
<TouchableHighlight onPress={this.onPress}>
<Text>push me!{this.state.flag && ' I \'m ' + this.state.flag + ', i come from second page'}</Text>
</TouchableHighlight>
</View>
);
},
onPress: function() {
var _me = this;
//或者写成 const navigator = this.props.navigator;
const { navigator } = this.props;
if(navigator)
{
navigator.push({
name: 'touch View',
component: SecondScene,
params: {
id: this.state.id,
getSomething:function(flag) {
_me.setState({
flag: flag
});
}
}
})
}
}
});
/*-- push后的页面组件 --*/
var SecondScene = React.createClass({
render: function() {
return (
<View style={styles.home}>
<TouchableHighlight onPress={this.onPress}>
<Text>push sucess!I get {this.props.id},i want back!</Text>
</TouchableHighlight>
</View>
);
},
onPress: function() {
//或者写成 const navigator = this.props.navigator;
const { navigator } = this.props;
if(this.props.getSomething) {
var flag = 'Axiba002'
this.props.getSomething(flag);
}
if(navigator) {
navigator.pop();
}
}
});
/*布局样式*/
var styles = StyleSheet.create({
container: {
flex: 1,
// justifyContent: 'center',
// alignItems: 'center',
backgroundColor: '#F5FCFF',
},
home: {
paddingTop:74,
},
});
AppRegistry.registerComponent('AwesonProject', () => MainClass);
- 补充一些可能会用到的Navigator方法:
- getCurrentRoutes() - 获取当前栈里的路由，也就是push进来，没有pop掉的那些。
- jumpBack() - 跳回之前的路由，当然前提是保留现在的，还可以再跳回来，会给你保留原样。
- jumpForward() - 上一个方法不是调到之前的路由了么，用这个跳回来就好了。
- jumpTo(route) - 跳转到已有的场景并且不卸载。
- push(route) - 跳转到新的场景，并且将场景入栈，你可以稍后跳转过去
- pop() - 跳转回去并且卸载掉当前场景
- replace(route) - 用一个新的路由替换掉当前场景
- replaceAtIndex(route, index) - 替换掉指定序列的路由场景
- replacePrevious(route) - 替换掉之前的场景
- immediatelyResetRouteStack(routeStack) - 用新的路由数组来重置路由栈
- popToRoute(route) - pop到路由指定的场景，其他的场景将会卸载。
- popToTop() - pop到栈中的第一个场景，卸载掉所有的其他场景。
NavigatorIOS
- NavigatorIOS包装了UIKit的导航功能，可以使用左划功能来返回到上一界面
- 同上包含的方法有：
- push(route) - 导航器跳转到一个新的路由。
- pop() - 回到上一页。
- popN(n) - 回到N页之前。当N=1的时候，效果和pop()一样。
- replace(route) - 替换当前页的路由，并立即加载新路由的视图。
- replacePrevious(route) - 替换上一页的路由/视图。
- replacePreviousAndPop(route) - 替换上一页的路由/视图并且立刻切换回上一页。
- resetTo(route) - 替换最顶级的路由并且回到它。
- popToRoute(route) - 一直回到某个指定的路由。
- popToTop() - 回到最顶层的路由。
- 代码demo：
/**
* Sample React Native App
* https://github.com/facebook/react-native
*/
'use strict';
var React = require('react-native');
//增加NavigatorIOS
var {
AppRegistry,
StyleSheet,
Text,
View,
NavigatorIOS,
TouchableHighlight,
} = React;
/*有这样一些需求？：自定义barBarItem，例如自定义名字、图片？*/
/*-- 启动组件 --*/
var MainClass = React.createClass({
onRightButtonPress:function(){
this.refs.nav.push({
title: 'push view',
component: SecondScene,
});
},
render: function() {
//component这里设置的是这个组件启动的时候显示的第一个子组件
return (
<NavigatorIOS ref='nav'
style= {styles.container}
initialRoute= {{
component: HomeScene,
title: 'home',
rightButtonTitle: 'more',
onRightButtonPress: this.onRightButtonPress,
}}>
</NavigatorIOS>
);
},
});
/*-- 首页页面组件 --*/
var HomeScene = React.createClass({
render: function() {
return (
<View style={styles.home}>
<TouchableHighlight onPress={this.onPress}>
<Text>push me!</Text>
</TouchableHighlight>
</View>
);
},
onPress: function() {
this.props.navigator.push({
title: 'touch View',
component: SecondScene,
passProps: { myProp: 'Axiba001' },
});
}
});
/*-- push后的页面组件 --*/
var SecondScene = React.createClass({
render: function() {
return (
<View style={styles.home}>
<Text>push sucess!{'hi,this is prams:'+ this.props.myProp}</Text>
</View>
);
},
});
/*布局样式*/
var styles = StyleSheet.create({
container: {
flex: 1,
// justifyContent: 'center',
// alignItems: 'center',
backgroundColor: '#F5FCFF',
},
home: {
paddingTop:74,
},
});
AppRegistry.registerComponent('AwesonProject', () => MainClass);
补充（来自React-Native中文网的翻译）
- 回调函数基本相同，但是注意还有一些对导航栏的控制，例如:
- barTintColor string
导航条的背景颜色。
- initialRoute {component: function, title: string, passProps: object, backButtonIcon: Image.propTypes.source, backButtonTitle: string, leftButtonIcon: Image.propTypes.source, leftButtonTitle: string, onLeftButtonPress: function, rightButtonIcon: Image.propTypes.source, rightButtonTitle: string, onRightButtonPress: function, wrapperStyle: [object Object]}
NavigatorIOS使用"路由"对象来包含要渲染的子视图、它们的属性、以及导航条配置。"push"和任何其它的导航函数的参数都是这样的路由对象。
- itemWrapperStyle
导航器中的组件的默认属性。一个常见的用途是设置所有页面的背景颜色。
- navigationBarHidden bool *
一个布尔值，决定导航栏是否隐藏。
- shadowHidden bool
一个布尔值，决定是否要隐藏1像素的阴影
- tintColor string
导航栏上按钮的颜色。
- titleTextColor string
导航器标题的文字颜色。
- translucent bool
一个布尔值，决定是否导航条是半透明的。
