您的位置:

React Navigation指南

一、初步了解React Navigation

React Navigation是由React Native社区所提供的一个用于跨平台应用程序的导航库。它为Android和iOS设备提供了一致的、原生的导航体验。它的灵活性使开发人员能够轻松地创建和管理在应用程序中浏览的屏幕和标签。

React Navigation支持多种导航类型,包括堆栈、标签和抽屉。通过使用Navigator、StackNavigator、TabNavigator和DrawerNavigator组件,可以轻松地创建能够响应路由和导航事件的应用程序。

下面是一个基本的React Navigation示例:


import React from 'react';
import { View, Text } from 'react-native';
import { createStackNavigator } from 'react-navigation';

class HomeScreen extends React.Component {
  render() {
    return (
      <View style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
        <Text>Home Screen</Text>
      </View>
    );
  }
}

const RootStack = createStackNavigator(
  {
    Home: HomeScreen,
  },
  {
    initialRouteName: 'Home',
  }
);

export default class App extends React.Component {
  render() {
    return <RootStack />;
  }
}

在上面的代码中,我们定义了一个HomeScreen组件,并使用createStackNavigator函数创建了一个堆栈导航器。堆栈导航器通过push和pop等函数实现了进入和退出屏幕的效果。最后,我们渲染了createStackNavigator返回的组件。

二、React Navigation的使用

1. 使用Stack Navigator

StackNavigator是一种堆栈导航器,通常在具有线性导航结构的应用程序中使用。基本上,StackNavigator是一种导航类型,允许用户在应用程序的不同屏幕之间穿梭。

下面是一个Stack Navigator的示例:


import React from 'react';
import { View, Text } from 'react-native';
import { createStackNavigator } from 'react-navigation';

class HomeScreen extends React.Component {
  render() {
    return (
      <View style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
        <Text>Home Screen</Text>
      </View>
    );
  }
}

class DetailsScreen extends React.Component {
  render() {
    return (
      <View style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
        <Text>Details Screen</Text>
      </View>
    );
  }
}

const RootStack = createStackNavigator(
  {
    Home: HomeScreen,
    Details: DetailsScreen,
  },
  {
    initialRouteName: 'Home',
  }
);

export default class App extends React.Component {
  render() {
    return <RootStack />;
  }
}

在上面的代码中,我们定义了两个组件:HomeScreen和DetailsScreen。我们使用createStackNavigator函数创建了一个堆栈导航器,并在其参数中指定了两个屏幕:Home和Details。我们还指定了initialRouteName选项,将首屏渲染为Home屏幕。

要将用户从一个屏幕导航到另一个屏幕,我们可以在任何组件中通过this.props.navigation.navigate函数来触发导航。在HomeScreen组件中,我们添加了一个按钮,当用户点击该按钮时,会将其导航到DetailsScreen屏幕。


import React from 'react';
import { View, Text, Button } from 'react-native';
import { createStackNavigator } from 'react-navigation';

class HomeScreen extends React.Component {
  render() {
    return (
      <View style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
        <Text>Home Screen</Text>
        <Button
          title="Go to Details"
          onPress={() => this.props.navigation.navigate('Details')}
        />
      </View>
    );
  }
}

class DetailsScreen extends React.Component {
  render() {
    return (
      <View style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
        <Text>Details Screen</Text>
      </View>
    );
  }
}

const RootStack = createStackNavigator(
  {
    Home: HomeScreen,
    Details: DetailsScreen,
  },
  {
    initialRouteName: 'Home',
  }
);

export default class App extends React.Component {
  render() {
    return <RootStack />;
  }
}

2. 使用Tab Navigator

Tab Navigator是一种导航类型,可以让用户在多个页面间轻松切换,常见于需要在页面之间切换的应用程序中。

下面是一个Tab Navigator的示例:


import React from 'react';
import { View, Text, Button } from 'react-native';
import { createBottomTabNavigator, createStackNavigator } from 'react-navigation';

class HomeScreen extends React.Component {
  render() {
    return (
      <View style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
        <Text>Home Screen</Text>
      </View>
    );
  }
}

class SettingsScreen extends React.Component {
  render() {
    return (
      <View style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
        <Text>Settings Screen</Text>
      </View>
    );
  }
}

class ProfileScreen extends React.Component {
  render() {
    return (
      <View style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
        <Text>Profile Screen</Text>
      </View>
    );
  }
}

const HomeStack = createStackNavigator({
  Home: HomeScreen,
  },
  {
    navigationOptions: {
      tabBarLabel: 'Home'
    }
  }
);

const SettingsStack = createStackNavigator({
  Settings: SettingsScreen,
  },
  {
    navigationOptions: {
      tabBarLabel: 'Settings'
    }
  }
);

const ProfileStack = createStackNavigator({
  Profile: ProfileScreen,
  },
  {
    navigationOptions: {
      tabBarLabel: 'Profile'
    }
  }
);

const RootStack = createBottomTabNavigator({
    HomeStack,
    SettingsStack,
    ProfileStack
});

export default class App extends React.Component {
  render() {
    return <RootStack />;
  }
}

在上面的代码中,我们使用createBottomTabNavigator函数创建了一个Tab Navigator,并在其参数中指定了三个屏幕:HomeStack、SettingsStack和ProfileStack。通过使用createStackNavigator,我们为每个屏幕定义了一个堆栈导航器。

注意,我们通过在每个堆栈导航器的选项中指定tabBarLabel属性来指定每个标签栏的标签标签。

3. 使用Drawer Navigator

Drawer Navigator使用侧边栏菜单或抽屉式导航,可以让用户在多个页面间轻松切换。

下面是一个Drawer Navigator的示例:


import React from 'react';
import { View, Text, Button } from 'react-native';
import { createDrawerNavigator, createStackNavigator } from 'react-navigation';

class HomeScreen extends React.Component {
  render() {
    return (
      <View style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
        <Text>Home Screen</Text>
        <Button
          title="Open Drawer"
          onPress={() => this.props.navigation.openDrawer()}
        />
      </View>
    );
  }
}

class SettingsScreen extends React.Component {
  render() {
    return (
      <View style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
        <Text>Settings Screen</Text>
      </View>
    );
  }
}

class ProfileScreen extends React.Component {
  render() {
    return (
      <View style={{ flex: 1, alignItems: 'center', justifyContent: 'center' }}>
        <Text>Profile Screen</Text>
      </View>
    );
  }
}

const HomeStack = createStackNavigator({
  Home: HomeScreen,
  },
  {
    navigationOptions: ({ navigation }) => ({
      headerLeft: <Button
        onPress={() => navigation.openDrawer()}
        title="Menu"
      />
    })
  }
);

const SettingsStack = createStackNavigator({
  Settings: SettingsScreen,
  });

const ProfileStack = createStackNavigator({
  Profile: ProfileScreen,
  });

const RootStack = createDrawerNavigator({
    Home: HomeStack,
    Settings: SettingsStack,
    Profile: ProfileStack
});

export default class App extends React.Component {
  render() {
    return <RootStack />;
  }
}

在上面的代码中,我们使用createDrawerNavigator函数创建了一个Drawer Navigator,并在其参数中指定了三个屏幕:HomeStack、SettingsStack和ProfileStack。我们定义了一个堆栈导航器来管理要在每个抽屉项目中显示的屏幕。

注意,我们通过在HomeStack的选项中设置headerLeft属性来为其添加一个自定义菜单按钮。当用户点击该按钮时,该组件的openDrawer方法将被触发,打开抽屉菜单。

三、总结

本文介绍了React Navigation库的基本知识,包括Stack Navigator、Tab Navigator和Drawer Navigator等导航类型的使用方法。通过使用Navigator、StackNavigator、TabNavigator和DrawerNavigator组件,开发人员可以轻松地创建和管理跨平台应用程序中的屏幕和标签。有了这些知识,开发人员就可以创建出更加复杂和多样化的应用程序。