React Native——使用導航Navigator and NavigatorIOS
一、Navigator
1、簡單介紹:大多數時候我們都需要導航器來應對不同場景(頁面)間的切換。它通過路由對象來分辨不同的場景,我們這里采用的就是 renderScene 方法,根據指定的路由來渲染。
2、利用Navigator彈出用到的方法:
(1 initialRoute ={{ name: 'home', component: HomeScene }} 這個指定了默認的頁面,也就是啟動的組件頁面
(2 configureScene ={() => {
return Navigator. SceneConfigs .HorizontalSwipeJump;
}}
這個是頁面之間跳轉時候的動畫,可以看這個目錄:
node_modules/react-native/Libraries/CustomComponents/Navigator/NavigatorSceneConfigs.js(可以看其他跳轉的時候的方向)
(3 renderScene :兩個參數中的route包含的事initial的時候傳遞的name和component,而navigator是一個我們需要用的Navigator的對象,所以當我們拿到route中的component的時候,我們就可以將navigator傳遞給它,正因為如此,我們的組件HomeScene才可以通過 this.props.navigator,拿到路由。
(4 如果需要傳參數,則在push的參數后面加多一個參數 params ,把JSON往死填就好了,這里的params,其實就是在renderScene中return的{...route.params},這樣接收的頁面只需要通過this.props.id,就可以拿到我們傳遞的參數
(5 OK,那參數怎么回傳呢?回調!通過定義一個回調函數,利用this.props 去調用,把參數回傳回來
完整代碼:
/** * Sample React Native App * https://github.com/非死book/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
1、NavigatorIOS包裝了UIKit的導航功能,可以使用左劃功能來返回到上一界面。
2、同上包含的方法有:
- push(route) - 導航器跳轉到一個新的路由。
- pop() - 回到上一頁。
- popN(n) - 回到N頁之前。當N=1的時候,效果和 pop() 一樣。
- replace(route) - 替換當前頁的路由,并立即加載新路由的視圖。
- replacePrevious(route) - 替換上一頁的路由/視圖。
- replacePreviousAndPop(route) - 替換上一頁的路由/視圖并且立刻切換回上一頁。
- resetTo(route) - 替換最頂級的路由并且回到它。
- popToRoute(route) - 一直回到某個指定的路由。
- popToTop() - 回到最頂層的路由。
代碼:
/** * Sample React Native App * https://github.com/非死book/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);
回調函數基本相同,但是注意還有一些對導航欄的控制,例如:
(1 barTintColor string
導航條的背景顏色。
(2 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"和任何其它的導航函數的參數都是這樣的路由對象。
(3 itemWrapperStyle View#style
導航器中的組件的默認屬性。一個常見的用途是設置所有頁面的背景顏色。
(4 navigationBarHidden bool
一個布爾值,決定導航欄是否隱藏。
( 5 shadowHidden bool
一個布爾值,決定是否要隱藏1像素的陰影
( 6 tintColor string
導航欄上按鈕的顏色。
( 7 titleTextColor string
導航器標題的文字顏色。
(8 translucent bool
一個布爾值,決定是否導航條是半透明的。