使用導(dǎo)航器可以讓你在應(yīng)用的不同場(chǎng)景(頁(yè)面)間進(jìn)行切換库车。導(dǎo)航器通過(guò)路由對(duì)象來(lái)分辨不同的場(chǎng)景。利用renderScene
方法樱拴,導(dǎo)航欄可以根據(jù)指定的路由來(lái)渲染場(chǎng)景柠衍。
可以通過(guò)configureScene
屬性獲取指定路由對(duì)象的配置信息洋满,從而改變場(chǎng)景的動(dòng)畫(huà)或者手勢(shì)。查看Navigator.SceneConfigs
來(lái)獲取默認(rèn)的動(dòng)畫(huà)和更多的場(chǎng)景配置選項(xiàng)珍坊。
譯注:本文檔的說(shuō)明較為簡(jiǎn)略牺勾,使用上有一定的難度。論壇中有一篇更為詳細(xì)的教程阵漏,推薦閱讀禽最。
截圖
基本用法
<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();
}
}}
/>
}
/>
或者更簡(jiǎn)易一些的
<TabNavigator>
{/*--------------首頁(yè)--*/}
<TabNavigator.Item
title = "首頁(yè)"
renderIcon={() => <Image source={{uri:'icon_tabbar_homepage'}} style={styles.iconStyle}/>}
renderSelectedIcon={() => <Image source={{uri:'icon_tabbar_homepage_selected'}} style={styles.iconStyle}/>}//選中圖標(biāo)
onPress={()=>{this.setState({selectedTab:'home'})}}
selected={this.state.selectedTab === 'home'}
>
<Navigator
initialRoute={{name: '首頁(yè)', component:Home}}
configureScene={()=>{
return Navigator.SceneConfigs.PushFromRight;
}}
renderScene={(route, navigator) =>{
let Component = route.component;
return <Component {...route.passProps} navigator={navigator}/>;
}}
/>
</TabNavigator.Item>
</TabNavigator>
導(dǎo)航方法
如果你得到了一個(gè)navigator對(duì)象的引用(譯注:再次推薦仔細(xì)閱讀此教程,理解如何在renderScene方法中傳遞navigator對(duì)象袱饭,否則直接調(diào)用會(huì)報(bào)undefined錯(cuò)誤)川无,則可以調(diào)用許多方法來(lái)進(jìn)行導(dǎo)航:
getCurrentRoutes() - 獲取當(dāng)前棧里的路由,也就是push進(jìn)來(lái)虑乖,沒(méi)有pop掉的那些懦趋。
jumpBack() - 跳回之前的路由,當(dāng)然前提是保留現(xiàn)在的疹味,還可以再跳回來(lái)仅叫,會(huì)給你保留原樣。
jumpForward() - 上一個(gè)方法不是調(diào)到之前的路由了么糙捺,用這個(gè)跳回來(lái)就好了诫咱。
jumpTo(route) - 跳轉(zhuǎn)到已有的場(chǎng)景并且不卸載。
push(route) - 跳轉(zhuǎn)到新的場(chǎng)景洪灯,并且將場(chǎng)景入棧坎缭,你可以稍后跳轉(zhuǎn)過(guò)去
pop() - 跳轉(zhuǎn)回去并且卸載掉當(dāng)前場(chǎng)景
replace(route) - 用一個(gè)新的路由替換掉當(dāng)前場(chǎng)景
replaceAtIndex(route, index) - 替換掉指定序列的路由場(chǎng)景
replacePrevious(route) - 替換掉之前的場(chǎng)景
resetTo(route) - 跳轉(zhuǎn)到新的場(chǎng)景,并且重置整個(gè)路由棧
immediatelyResetRouteStack(routeStack) - 用新的路由數(shù)組來(lái)重置路由棧
popToRoute(route) - pop到路由指定的場(chǎng)景签钩,在整個(gè)路由棧中掏呼,處于指定場(chǎng)景之后的場(chǎng)景將會(huì)被卸載。
popToTop() - pop到棧中的第一個(gè)場(chǎng)景铅檩,卸載掉所有的其他場(chǎng)景憎夷。
屬性
configureScene function
可選的函數(shù),用來(lái)配置場(chǎng)景動(dòng)畫(huà)和手勢(shì)昧旨。會(huì)帶有兩個(gè)參數(shù)調(diào)用拾给,一個(gè)是當(dāng)前的路由,一個(gè)是當(dāng)前的路由棧兔沃。然后它應(yīng)當(dāng)返回一個(gè)場(chǎng)景配置對(duì)象
(route, routeStack) => Navigator.SceneConfigs.FloatFromRight
Navigator.SceneConfigs.PushFromRight (默認(rèn))
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
定義啟動(dòng)時(shí)加載的路由蒋得。路由是導(dǎo)航欄用來(lái)識(shí)別渲染場(chǎng)景的一個(gè)對(duì)象。initialRoute
必須是initialRouteStack
中的一個(gè)路由粘拾。initialRoute
默認(rèn)為initialRouteStack
中最后一項(xiàng)窄锅。
initialRouteStack [object]
提供一個(gè)路由集合用來(lái)初始化创千。如果沒(méi)有設(shè)置初始路由的話則必須設(shè)置該屬性缰雇。如果沒(méi)有提供該屬性入偷,它將被默認(rèn)設(shè)置成一個(gè)只含有initialRoute
的數(shù)組。
navigationBar node
可選參數(shù)械哟,提供一個(gè)在場(chǎng)景切換的時(shí)候保持的導(dǎo)航欄疏之。
navigator object
可選參數(shù),提供從父導(dǎo)航器獲得的導(dǎo)航器對(duì)象暇咆。
onDidFocus function
每當(dāng)導(dǎo)航切換完成或初始化之后锋爪,調(diào)用此回調(diào),參數(shù)為新場(chǎng)景的路由爸业。
onWillFocus function
會(huì)在導(dǎo)航切換之前調(diào)用其骄,參數(shù)為目標(biāo)路由。
renderScene function
必要參數(shù)扯旷。用來(lái)渲染指定路由的場(chǎng)景拯爽。調(diào)用的參數(shù)是路由和導(dǎo)航器。
(route, navigator) => <MySceneComponent title={route.title} navigator={navigator} />
sceneStyle View#style
將會(huì)應(yīng)用在每個(gè)場(chǎng)景的容器上的樣式钧忽。