React Native 的頁面切換靠 Navigator 元件負責,而頁面之間要帶資料過去,則是把參數塞進 route 物件裡。本文示範一個很典型的流程:註冊頁輸入手機號,按下註冊後跳到結果頁,並把手機號帶過去顯示「xx 註冊成功」。
路由中樞:index.Android.js
這個檔案有三個職責:告訴 Navigator 切換時要用哪種轉場動畫、決定每個 route 名稱對應哪個畫面、以及處理 Android 實體返回鍵。
'use strict'
import React, { Component } from 'react';
import { AppRegistry, Navigator, BackAndroid } from 'react-native';
var Register = require('./study/Register');
let RegisterResult = require('./study/RegisterResult');
var NaviModule = React.createClass({
// 決定畫面切換的轉場效果
configureScene: function(route){
return Navigator.SceneConfigs.FadeAndroid;
},
// 依 route 名稱決定要掛上哪個畫面
renderScene: function(router, navigator){
this._navigator = navigator;
switch(router.name){
case "register":
return <Register navigator = {navigator}/>
case "registerResult":
return <RegisterResult
telephoneNumber = {router.telephoneNumber}
navigator = {navigator}/>
}
},
// 生命週期:元件掛載時攔截實體返回鍵
componentDidMount: function(){
var navigator = this._navigator;
BackAndroid.addEventListener('NaviModuleListener', () => {
if (navigator && navigator.getCurrentRoutes().length > 1) {
navigator.pop();
return true;
}
return false;
});
},
componentWillUnmount: function(){
BackAndroid.removeEventListener('NaviModuleListener');
},
render: function(){
return (
<Navigator
initialRoute = {{name:'register'}}
configureScene = {this.configureScene}
renderScene = {this.renderScene} />
);
}
});
AppRegistry.registerComponent('FirstDemo', () => NaviModule);
這裡有個容易忽略的細節:renderScene 把 navigator 當 prop 傳給每個子畫面,子畫面才有辦法呼叫 push / replace。同時 route 上掛的 telephoneNumber 會被取出來,當成 prop 交給結果頁。
註冊頁:Register.js
'use strict'
import React, { Component } from 'react';
import { AppRegistry, StyleSheet, Text, View, TextInput } from 'react-native';
let Dimensions = require('Dimensions');
let totalWidth = Dimensions.get('window').width;
let leftStartPoint = totalWidth * 0.1;
let componetWidth = totalWidth * 0.8;
let Register = React.createClass({
getInitialState: function(){
return { inputedNum: '', inputedPW: '' };
},
updatePW: function(newText){
this.setState({ inputedPW: newText });
},
render: function() {
return (
<View style={styles.container}>
<TextInput
style = {styles.numberInputStyle}
placeholder = {'請輸入手機號'}
onChangeText = {(aa) => this.setState({inputedNum: aa})}/>
<Text style={styles.textPromptStyle}>
您輸入的手機號:{this.state.inputedNum}
</Text>
<TextInput
style={styles.passwordInputStyle}
placeholder = {'請輸入手機號密碼'}
password = {true}
onChangeText = {(newText) => this.updatePW(newText)}/>
<Text style={styles.bigTextPrompt} onPress = {this.userRegister}>
注 冊
</Text>
</View>
);
},
userRegister: function(){
this.props.navigator.replace({
telephoneNumber : this.state.inputedNum,
name: 'registerResult',
});
}
});
const styles = StyleSheet.create({
container: {
flex: 1, flexDirection:'column', justifyContent: 'center',
backgroundColor: '#F5FCFF',
},
numberInputStyle:{ top:20, left:leftStartPoint, width:componetWidth,
backgroundColor:'gray', fontSize:20 },
textPromptStyle:{ top:30, left:leftStartPoint, width:componetWidth, fontSize:20 },
passwordInputStyle:{ top:50, left:leftStartPoint, width:componetWidth,
backgroundColor:'gray', fontSize:20 },
bigTextPrompt:{ top:70, left:leftStartPoint, width:componetWidth,
backgroundColor:'gray', color:'white',
textAlign:'center', fontSize:60 }
});
module.exports = Register;
結果頁:RegisterResult.js
'use strict'
import React, { Component } from 'react';
import { AppRegistry, StyleSheet, Text, View, TextInput } from 'react-native';
let RegisterResult = React.createClass({
render: function(){
return (
<View style = {styles.container}>
<Text style = {styles.text}>
{this.props.telephoneNumber} 註冊成功
</Text>
</View>
);
}
});
const styles = StyleSheet.create({
container: {
flex: 1, flexDirection:'column', justifyContent: 'center', alignItems:'center',
backgroundColor: '#F5FCFF',
},
text:{ flexWrap:'wrap', backgroundColor:'gray', fontSize:20,
paddingTop:10, paddingBottom:10, paddingLeft:25, paddingRight:25 },
});
module.exports = RegisterResult;
觀念釐清
資料流動的方向其實很單純:註冊頁把值放進 route 物件,renderScene 把它拆出來轉成 prop,結果頁用 this.props 讀取。中間沒有全域狀態,完全是靠導航堆疊在傳遞。
這裡刻意用了 replace 而不是 push:註冊完成後不該再退回填表單的畫面,用 replace 直接把註冊頁從堆疊裡換掉,使用者按返回鍵的行為才符合預期。
另外 BackAndroid 那段的判斷是「堆疊超過一層就 pop,否則交還系統處理」,少了這個判斷,Android 使用者按返回鍵會直接關掉 App,而不是回到上一頁。
以上就是 React Native 頁面跳轉與值傳遞的完整實作,掌握 route 物件這個載體,後續要傳更複雜的結構也只是往裡面塞而已。