使用導航器可以讓你在應用的不同場景(頁面)間進行切換。導航器通過路由對象來分辨不同的場景。利用renderScene
方法,導航欄可以根據指定的路由來渲染場景。
可以通過configureScene
屬性獲取指定路由對象的配置信息,從而改變場景的動畫或者手勢。查看Navigator.SceneConfigs
來獲取默認的動畫和更多的場景配置選項。
譯注:本文檔的說明較為簡略,使用上有一定的難度。論壇中有一篇更為詳細的教程,推薦閱讀。
截圖
基本用法
<Navigator
initialRoute={{name: 'My First Scene', index: 0}}
renderScene={(route, navigator) =>
<MySceneComponent
name={route.name}
onForward={() => {
var nextIndex = route.index + 1;
navigator.push({
name: 'Scene ' + nextIndex,
index: nextIndex,
});
}}
onBack={() => {
if (route.index > 0) {
navigator.pop();
}
}}
/>
}
/>
或者更簡易一些的
<TabNavigator>
{/*--------------首頁--*/}
<TabNavigator.Item
title = "首頁"
renderIcon={() => <Image source={{uri:'icon_tabbar_homepage'}} style={styles.iconStyle}/>}
renderSelectedIcon={() => <Image source={{uri:'icon_tabbar_homepage_selected'}} style={styles.iconStyle}/>}//選中圖標
onPress={()=>{this.setState({selectedTab:'home'})}}
selected={this.state.selectedTab === 'home'}
>
<Navigator
initialRoute={{name: '首頁', component:Home}}
configureScene={()=>{
return Navigator.SceneConfigs.PushFromRight;
}}
renderScene={(route, navigator) =>{
let Component = route.component;
return <Component {...route.passProps} navigator={navigator}/>;
}}
/>
</TabNavigator.Item>
</TabNavigator>
導航方法
如果你得到了一個navigator對象的引用(譯注:再次推薦仔細閱讀此教程,理解如何在renderScene方法中傳遞navigator對象,否則直接調用會報undefined錯誤),則可以調用許多方法來進行導航:
getCurrentRoutes() - 獲取當前棧里的路由,也就是push進來,沒有pop掉的那些。
jumpBack() - 跳回之前的路由,當然前提是保留現在的,還可以再跳回來,會給你保留原樣。
jumpForward() - 上一個方法不是調到之前的路由了么,用這個跳回來就好了。
jumpTo(route) - 跳轉到已有的場景并且不卸載。
push(route) - 跳轉到新的場景,并且將場景入棧,你可以稍后跳轉過去
pop() - 跳轉回去并且卸載掉當前場景
replace(route) - 用一個新的路由替換掉當前場景
replaceAtIndex(route, index) - 替換掉指定序列的路由場景
replacePrevious(route) - 替換掉之前的場景
resetTo(route) - 跳轉到新的場景,并且重置整個路由棧
immediatelyResetRouteStack(routeStack) - 用新的路由數組來重置路由棧
popToRoute(route) - pop到路由指定的場景,在整個路由棧中,處于指定場景之后的場景將會被卸載。
popToTop() - pop到棧中的第一個場景,卸載掉所有的其他場景。
屬性
configureScene function
可選的函數,用來配置場景動畫和手勢。會帶有兩個參數調用,一個是當前的路由,一個是當前的路由棧。然后它應當返回一個場景配置對象
(route, routeStack) => Navigator.SceneConfigs.FloatFromRight
Navigator.SceneConfigs.PushFromRight (默認)
Navigator.SceneConfigs.FloatFromRight
Navigator.SceneConfigs.FloatFromLeft
Navigator.SceneConfigs.FloatFromBottom
Navigator.SceneConfigs.FloatFromBottomAndroid
Navigator.SceneConfigs.FadeAndroid
Navigator.SceneConfigs.HorizontalSwipeJump
Navigator.SceneConfigs.HorizontalSwipeJumpFromRight
Navigator.SceneConfigs.VerticalUpSwipeJump
Navigator.SceneConfigs.VerticalDownSwipeJump
initialRoute object
定義啟動時加載的路由。路由是導航欄用來識別渲染場景的一個對象。initialRoute
必須是initialRouteStack
中的一個路由。initialRoute
默認為initialRouteStack
中最后一項。
initialRouteStack [object]
提供一個路由集合用來初始化。如果沒有設置初始路由的話則必須設置該屬性。如果沒有提供該屬性,它將被默認設置成一個只含有initialRoute
的數組。
navigationBar node
可選參數,提供一個在場景切換的時候保持的導航欄。
navigator object
可選參數,提供從父導航器獲得的導航器對象。
onDidFocus function
每當導航切換完成或初始化之后,調用此回調,參數為新場景的路由。
onWillFocus function
會在導航切換之前調用,參數為目標路由。
renderScene function
必要參數。用來渲染指定路由的場景。調用的參數是路由和導航器。
(route, navigator) => <MySceneComponent title={route.title} navigator={navigator} />
sceneStyle View#style
將會應用在每個場景的容器上的樣式。