从navigator到react-navigation进阶教程

最新推荐文章于 2024-02-24 23:14:04 发布

Night_SaaS

最新推荐文章于 2024-02-24 23:14:04 发布

阅读量295

点赞数

文章标签： RN

随着react-navigation逐渐稳定，Navigator也被光荣的退休了。在React Native生态环境中需要一款可扩展且易于使用的导航组件，Navigator 自然胜任不了，这时React Native社区便孕育出了一个开源导航组件react-navigation。

react-navigation的出现替代了Navigator、 Ex-Navigation等老一代的导航组件，react-navigation可以说是Navigator的加强版，不仅有Navigator的全部功能，另外还支持底部导航类似于与iOS中的UITabBarController，此外它也支持侧拉效果方式的导航类似于Android中的抽屉效果。

什么是导航器？

导航器也可以看成一个是普通的React组件，你可以通过导航器来定义你的App的导航结构。导航器还可以渲染通用元素，例如可以配置的标题栏和选项卡栏。

在react-navigation中有以下三种类型的导航器：

StackNavigator: 类似于普通的Navigator，屏幕上方导航栏；
TabNavigator: 相当于iOS里面的TabBarController，屏幕下方的标签栏；
DrawerNavigator: 抽屉效果，侧边滑出；

{:height="90%" width="90%"}

你可以通过以上三种导航器来创建你APP，可以是其中一个也可以多个组合，这个可以根据具体的应用场景并结合每一个导航器的特性进行选择。

在开始学习三种导航器之前，我们需要先了解两个和导航关于概念：

Screen navigation prop(屏幕导航属性)：通过navigation可以完成屏幕之间的调度操作，例如打开另一个屏幕；
Screen navigationOptions(屏幕导航选项)：通过navigationOptions可以定制导航器显示屏幕的方式（例如：头部标题，选项卡标签等）；

导航器所支持的Props

const SomeNav = StackNavigator/TabNavigator/DrawerNavigator({
// config
});
<SomeNav
screenProps={xxx}
ref={nav => { navigation = nav; }}
onNavigationStateChange=(prevState, newState, action)=>{
}
/>

@全新导航器react-navigation精讲

ref：可以通过ref属性获取到navigation；
onNavigationStateChange(prevState, newState, action)：顶级节点除了ref属性之外，还接受onNavigationStateChange(prevState, newState, action)属性，每次当导航器所管理的state发生改变时，都会回调该方法；
- prevState：变化之前的state；
- newState：新的state；
- 导致state变化的action；
screenProps：向子屏幕传递额外的数据，子屏幕可以通过this.props.screenProps获取到该数据。

Screen Navigation Prop(屏幕的navigation Prop)

当导航器中的屏幕被打开时，它会收到一个navigation prop，navigation prop是整个导航环节的关键一员，接下来就详细讲解一下navigation的作用。

navigation包含一下功能：

navigate：跳转到其他界面；
state：屏幕的当前state；
setParams：改变路由的params；
goBack：关闭当前屏幕；
dispatch：向路由发送一个action；

注意：一个navigation有可能没有navigate、setParams以及goBack，只有state与dispatch，所以在使用navigate时要进行判断，如果没有navigate可以使用navigation去dispatch一个新的action。如：

const {navigation,theme,selectedTab}=this.props;
const resetAction = NavigationActions.reset({
index: 0,
actions: [
NavigationActions.navigate({
routeName: 'HomePage',
params:{
theme:theme,
selectedTab:selectedTab
},
})
]
})
navigation.dispatch(resetAction)

@全新导航器react-navigation精讲

使用navigate进行界面之间的跳转

navigate(routeName, params, action)
- routeName：要跳转到的界面的路由名，也就是在导航其中配置的路由名；
- params：要传递给下一个界面的参数；
- action：如果该界面是一个navigator的话，将运行这个sub-action。

export const AppStackNavigator = StackNavigator({
HomeScreen: {
screen: HomeScreen
},
Page1: {
screen: Page1
})
class HomeScreen extends React.Component {
render() {
const {navigate} = this.props.navigation;
return (
<View>
<Text>This is HomeScreen</Text>
<Button
onPress={() => navigate( 'Page1', {name: 'Devio'})}
title= "Go to Page1"
/>
</View>
)
}
}

@全新导航器react-navigation精讲

使用state的params

可以通过this.props.state.params来获取通过setParams()，或navigation.navigate()传递的参数。

<Button
title={params.mode === 'edit' ? '保存' : '编辑'}
onPress={() =>
setParams({mode: params.mode === 'edit' ? '' : 'edit'})}
/>
<Button
title= "Go To Page1"
onPress={() => {
navigation.navigate( 'Page1',{ name: 'Devio' });
}}
/>
const {navigation} = this.props;
const {state, setParams} = navigation;
const {params} = state;
const showText = params.mode === 'edit' ? '正在编辑' : '编辑完成';

@全新导航器react-navigation精讲

使用setParams 改变route params

setParams: function setParams(params)：我们可以借助setParams来改变route params，比如，通过setParams来更新页面顶部的标题，返回按钮等；

class ProfileScreen extends React.Component {
render() {
const { setParams} = this.props.navigation;
return (
<Button
onPress={() => setParams({name: 'Lucy'})}
title= "Set title name to 'Lucy'"
/>
)
}
}

@全新导航器react-navigation精讲

注意navigation.setParams改变的是当前页面的Params，如果要改变其他页面的Params可以通过NavigationActions.setParams完成，下文会讲到。

使用goBack返回到上一页面或指定页面

goBack: function goBack(key)：我们可以借助goBack返回到上一页或者路由栈的指定页面。
- 其中key表示你要返回到页面的页面标识如id-1517035332238-4，不是routeName。
- 可以通过指定页面的navigation.state.key来获得页面的标识。
- key非必传，也可传null。
1. navigation.state
2. {params: {…}, key: "id-1517035332238-4", routeName: "Page1"} ```

export default class Page1 extends React.Component {
render() {
const {navigation} = this.props;
return <View style={{flex: 1, backgroundColor: "gray",}}>
<Text style={styles.text}>欢迎来到Page1</Text>
<Button
title= "Go Back"
onPress={() => {
navigation.goBack();
}}
/>
</View>
}
}

@全新导航器react-navigation精讲

通过dispatch发送一个action

dispatch: function dispatch(action)：给当前界面设置action，会替换原来的跳转，回退等事件。

const resetAction = NavigationActions.reset({
index: 0,
actions: [
NavigationActions.navigate({
routeName: 'HomePage',
params:{
theme:theme,
selectedTab:selectedTab
},
})
]
})
navigation.dispatch(resetAction)

@全新导航器react-navigation精讲

NavigationActions

Navigate : 导航到其他的页面；
Reset : 重置当前 state 到一个新的state；
Back : 返回到上一个页面；
Set Params : 设置指定页面的Params；
Init : 初始化一个 state 如果 state 是 undefined；

Navigate：

Navigatie action会使用Navigate action的结果来更新当前的state。

routeName：字符串，必选项，在app的router里注册的导航目的地的routeName。
params：对象，可选项，融合进目的地route的参数。
actions：对象，可选项(高级)，如果screen也是一个navigator，次级action可以在子router中运行。在文档中描述的任何actions都可以作为次级action。

import { NavigationActions } from 'react-navigation'
const navigateAction = NavigationActions.navigate({
routeName: 'Profile',
params: {},
action: NavigationActions.navigate({ routeName: 'SubProfileRoute'})
})
this.props.navigation.dispatch(navigateAction)

@全新导航器react-navigation精讲

Reset：

Reset action删掉所有的navigation state并且使用这个actions的结果来代替。

index，number，必选，navigation state中route数组中激活route的index。
actions，array，必选项，Navigation Actions数组，将会替代navigation state。

import { NavigationActions } from 'react-navigation'
const resetAction = NavigationActions.reset({
index: 0,
actions: [
NavigationActions.navigate({ routeName: 'Profile'})
]
})
this.props.navigation.dispatch(resetAction)

@全新导航器react-navigation精讲

使用场景比如进入APP首页后的splash页不在使用，这时可以使用NavigationActions.reset重置它。

index参数被用来定制化当前激活的route。举个例子：使用两个routes WelcomePage和HomePage给一个基础的stack navigation设置。为了重置route到HomePage，但是在堆栈中又存放在WelcomePage之上，你可以这么做:

import { NavigationActions } from 'react-navigation'
const resetAction = NavigationActions.reset({
index: 1,
actions: [
NavigationActions.navigate({ routeName: 'WelcomePage'}),
NavigationActions.navigate({ routeName: 'HomePage'})
]
});
this.props.navigation.dispatch(resetAction);

@全新导航器react-navigation精讲

Back

返回到前一个screen并且关闭当前screen.backaction creator接受一个可选的参数:

key：这个可以和上文中讲到的goBack的key是一个概念；

import { NavigationActions } from 'react-navigation'
const backAction = NavigationActions.back();
this.props.navigation.dispatch(backAction);

SetParams

通过SetParams我们可以修改指定页面的Params。

params：对象，必选参数，将会被合并到已经存在页面的Params中。
key：字符串，必选参数，页面的key。

import { NavigationActions } from 'react-navigation'
const setParamsAction = NavigationActions.setParams({
params: { title: 'HomePage' },
key: 'id-1517035332238-4',
});

有很多小伙伴可能会问：navigation中有setParams为什么还要有NavigationActions.setParams?

我从两方面来回答一下这个问题：

在上文中讲到过navigation中有可能只有state与dispatch，这个时候如果要修改页面的Params，则只能通过NavigationActions.setParams了；
另外，navigation.setParams只能修改当前页面的Params，而NavigationActions.setParams可以修改所有页面的Params；