React Native 早期版本裡,頁面跳轉主要靠 Navigator 完成。它其實就是一個路由棧管理器,通過 push、pop、replace 等操作在頁面之間切換,作用相當於 Android 原生的任務棧。
這個方法的作用有點像 Activity 裡的 startActivity,我們在其中決定要渲染的場景。它接收兩個必要參數:route(當前路由對象)和 navigator(導航器實例)。因為 navigator 上有 push、pop、jump 等方法,需要把它傳給子頁面,子頁面才有能力發起跳轉。而 route 需要我們提前配置好。
renderScene={(route, navigator) => {
let Component = route.component;
return <Component {...route.params} navigator={navigator} />
}}
route 通過 initialRoute 進行初始化:
initialRoute={{ name: defaultName, component: defaultComponent }}
initialRoute 是一個對象,只要給出頁面名稱和對應組件,就完成了路由初始化。回到 renderScene,route.component 就是 initialRoute 裡配置的組件,return 出去即完成渲染。
實戰中建議加一個空值判斷,避免配置缺失時直接崩潰:
renderScene={(route, navigator) => {
let Component = route.component;
if (route.component) {
return <Component {...route.params} navigator={navigator} />
}
}}
這個方法用來指定路由的場景配置,可以改變切換動畫與手勢。
configureScene={(route) => {
// 跳轉的動畫
return Navigator.SceneConfigs.VerticalDownSwipeJump;
}}
Navigator.SceneConfigs 提供了大量預設動畫,具體可查閱:
MyProject\node_modules\React-native\Libraries\CustomComponents\Navigator\NavigatorSceneConfigs.js
至此,從默認頁到自定義頁的跳轉鏈路就通了。完整代碼:
'use strict';
import React, {
AppRegistry, Component, StyleSheet, Text, Image, TextInput, View, Navigator
} from 'react-native';
import FirstPageComponent from './app/src/FirstPageComponent';
export default class MyProject extends React.Component {
render() {
var defaultName = 'FirstPageComponent';
var defaultComponent = FirstPageComponent;
return (
<Navigator
// 指定默認頁面,即啟動 app 後看到的第一屏,需要 name 和 component 兩個參數
initialRoute={{ name: defaultName, component: defaultComponent }}
configureScene={(route) => {
// 跳轉的動畫
return Navigator.SceneConfigs.FadeAndroid;
}}
renderScene={(route, navigator) => {
let Component = route.component;
if (route.component) {
return <Component navigator={navigator} />
}
}}
/>
);
}
}
AppRegistry.registerComponent('MyProject', () => MyProject);
FirstPageComponent 這裡是個只放了一行 Text 的自定義組件:
import React, { View, Text } from 'react-native';
export default class FirstPageComponent extends React.Component {
constructor(props) {
super(props);
this.state = {};
}
render() {
return (
<View>
<Text>我是默認頁面</Text>
</View>
);
}
}
由於跳轉時我們把 navigator 作為屬性傳了下去,子頁面裡就能直接取到它並調用其方法。
先給 Text 包一層可點擊區域:
render() {
return (
<View>
<TouchableOpacity onPress={this._pressButton.bind(this)}>
<Text>點我跳轉</Text>
</TouchableOpacity>
</View>
);
}
然後實現點擊方法:
_pressButton() {
const { navigator } = this.props;
if (navigator) {
navigator.push({
name: 'SecondPageComponent',
component: SecondPageComponent,
});
}
}
push 接收一個 route 對象,把名稱和組件壓入路由棧,頁面就切換過去了。改造後的 FirstPageComponent:
import React, { View, Text, TouchableOpacity } from 'react-native';
import SecondPageComponent from './SecondPageComponent';
export default class FirstPageComponent extends React.Component {
constructor(props) {
super(props);
this.state = {};
}
_pressButton() {
const { navigator } = this.props;
if (navigator) {
navigator.push({
name: 'SecondPageComponent',
component: SecondPageComponent,
});
}
}
render() {
return (
<View>
<TouchableOpacity onPress={this._pressButton.bind(this)}>
<Text>點我跳轉</Text>
</TouchableOpacity>
</View>
);
}
}
第二頁要返回,調用 pop 把當前場景出棧即可:
import React, { View, Text, TouchableOpacity } from 'react-native';
export default class SecondPageComponent extends React.Component {
constructor(props) {
super(props);
this.state = {};
}
_pressButton() {
const { navigator } = this.props;
if (navigator) {
navigator.pop();
}
}
render() {
return (
<View>
<TouchableOpacity onPress={this._pressButton.bind(this)}>
<Text>點我跳轉回去</Text>
</TouchableOpacity>
</View>
);
}
}
getCurrentRoutes():獲取當前棧裡所有路由,即已 push 且未 pop 的那些。jumpBack():跳回上一個路由,但保留當前棧,之後還能跳回來。jumpForward():與 jumpBack 配對,跳回之前保留的路由。jumpTo(route):跳到已有場景,不卸載。push(route):進入新場景並入棧。pop():返回並卸載當前場景。replace(route):用新路由替換當前場景。replaceAtIndex(route, index):替換指定位置的路由。replacePrevious(route):替換上一個場景。immediatelyResetRouteStack(routeStack):用新的路由數組重置整個棧。popToRoute(route):一路 pop 到指定場景,其餘全部卸載。popToTop():直接 pop 回棧底第一個場景,卸載其他所有場景。先理清三者關係:app 啟動進入 MyProject,MyProject 裡放著 Navigator,Navigator 用 initialRoute 加載 FirstPageComponent 並渲染到屏幕。第二頁並不是由第一頁直接 new 出來的,而是導航器操縱路由棧呈現的。
所以傳參的正確路徑是:第一頁把參數交給 push 的 route,Navigator 在 renderScene 裡展開 route.params 傳給目標組件。
第一頁的點擊事件改成:
navigator.push({
name: 'SecondPageComponent',
component: SecondPageComponent,
params: { message: 'I am from FirstPageComponent' },
})
Navigator 的 renderScene 展開 params:
renderScene={(route, navigator) => {
let Component = route.component;
if (route.component) {
return <Component {...route.params} navigator={navigator} />
}
}}
第二頁就能通過 props 拿到值,通常在 componentDidMount 中落到 state:
componentDidMount() {
this.setState({
message: this.props.message,
});
}
如果需要返回時帶數據回來,可以在 push 的 params 裡塞一個回調函數,第二頁執行它並把結果寫回第一頁的 state,這是最直觀的做法。
index.android.js
'use strict';
import React, {
AppRegistry, Component, StyleSheet, Text, Image, TextInput, View, Navigator
} from 'react-native';
import FirstPageComponent from './app/src/FirstPageComponent';
export default class MyProject extends React.Component {
render() {
var defaultName = 'FirstPageComponent';
var defaultComponent = FirstPageComponent;
return (
<Navigator
initialRoute={{ name: defaultName, component: defaultComponent }}
configureScene={(route) => {
return Navigator.SceneConfigs.FadeAndroid;
}}
renderScene={(route, navigator) => {
let Component = route.component;
if (route.component) {
return <Component {...route.params} navigator={navigator} />
}
}}
/>
);
}
}
AppRegistry.registerComponent('MyProject', () => MyProject);
FirstPageComponent.js
import React, { View, Text, TouchableOpacity } from 'react-native';
import SecondPageComponent from './SecondPageComponent';
export default class FirstPageComponent extends React.Component {
constructor(props) {
super(props);
this.state = {
resultMessage: 'hello',
};
}
_pressButton() {
var _this = this;
const { navigator } = this.props;
if (navigator) {
navigator.push({
name: 'SecondPageComponent',
component: SecondPageComponent,
params: {
message: 'I am from FirstPageComponent',
getResult: function (myMessage) {
_this.setState({ resultMessage: myMessage });
},
},
});
}
}
render() {
return (
<View>
<TouchableOpacity onPress={this._pressButton.bind(this)}>
<Text>{this.state.resultMessage}</Text>
</TouchableOpacity>
</View>
);
}
}
SecondPageComponent.js
import React, { View, Text, TouchableOpacity } from 'react-native';
export default class SecondPageComponent extends React.Component {
constructor(props) {
super(props);
this.state = { message: '' };
}
componentDidMount() {
this.setState({ message: this.props.message });
}
_pressButton() {
const { navigator } = this.props;
if (this.props.getResult) {
this.props.getResult('This is from SecondPageComponent');
}
if (navigator) {
navigator.pop();
}
}
render() {
return (
<View>
<TouchableOpacity onPress={this._pressButton.bind(this)}>
<Text>{this.state.message}</Text>
</TouchableOpacity>
</View>
);
}
}
最終效果:

一句話概括 Navigator 的思維模型:所有跳轉本質上都是對路由棧的操作,參數則跟著 route 對象在棧裡流動。理解這一點,各種 pop、replace、jump 的場景就不容易用錯。