DIV CSS 佈局教程網

ReactNative 頁面跳轉實戰:Navigator 路由棧與參數傳遞
編輯:JavaScript技巧     

React Native 早期版本裡,頁面跳轉主要靠 Navigator 完成。它其實就是一個路由棧管理器,通過 push、pop、replace 等操作在頁面之間切換,作用相當於 Android 原生的任務棧。

renderScene:決定渲染哪個頁面

這個方法的作用有點像 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:控制轉場動畫

這個方法用來指定路由的場景配置,可以改變切換動畫與手勢。

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>
    );
  }
}

Navigator 的常用方法

  1. getCurrentRoutes():獲取當前棧裡所有路由,即已 push 且未 pop 的那些。
  2. jumpBack():跳回上一個路由,但保留當前棧,之後還能跳回來。
  3. jumpForward():與 jumpBack 配對,跳回之前保留的路由。
  4. jumpTo(route):跳到已有場景,不卸載。
  5. push(route):進入新場景並入棧。
  6. pop():返回並卸載當前場景。
  7. replace(route):用新路由替換當前場景。
  8. replaceAtIndex(route, index):替換指定位置的路由。
  9. replacePrevious(route):替換上一個場景。
  10. immediatelyResetRouteStack(routeStack):用新的路由數組重置整個棧。
  11. popToRoute(route):一路 pop 到指定場景,其餘全部卸載。
  12. 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 的場景就不容易用錯。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved