官网地址:
https://reactnavigation.org/docs/navigators/custom
导航器跳转页面
译注:从0.44版本开始,Navigator被从react native的核心组件库中剥离到了一个名为react-native-deprecated-custom-components的单独模块中。如果你需要继续使用Navigator,则需要先npm i facebookarchive/react-native-custom-components安装,然后从这个模块中import,即import { Navigator } from 'react-native-deprecated-custom-components'.
github地址:https://github.com/wix/react-native-navigation
navigation的安装
npm install --save react-navigation
或
yarn add react-navigation
React Navigation默认的导航器:
- StackNavigator - 提供了一种应用程序在屏幕之间转换的方法,其中每个新屏幕都放置在堆栈的顶部。
- TabNavigator - 带有多个选项卡.
- DrawerNavigator - 带有抽屉导航.
创建导航器
import { StackNavigator } from 'react-navigation';
const RootNavigator = StackNavigator({
});
export default RootNavigator;
StackNavigator 基础用法/属性介绍
export const SimpleApp = StackNavigator({
Home: {screen: HomePage,
},
Chat: { screen: MyPage },
CustomKeyPage: { screen: CustomKeyPage },
},{
// 导航栏的显示模式, screen: 有渐变透明效果, float: 无透明效果, none: 隐藏导航栏
headerMode:'none'
});
导航配置
- screen:对应界面名称,需要填入import之后的页面。
- navigationOptions:配置StackNavigator的一些属性。
- title:标题,如果设置了这个导航栏和标签栏的title就会变成一样的,所以不推荐使用这个方法。
- header:可以设置一些导航的属性,当然如果想隐藏顶部导航条只要将这个属性设置为null就可以了。
- headerTitle:设置导航栏标题,推荐用这个方法。
- headerBackTitle:设置跳转页面左侧返回箭头后面的文字,默认是上一个页面的标题。可以自定义,也可以设置为null
- ****headerTruncatedBackTitle****:设置当上个页面标题不符合返回箭头后的文字时,默认改成"返回"。(上个页面的标题过长,导致显示不下,所以改成了短一些的。)
- headerRight:设置导航条右侧。可以是按钮或者其他。
- headerLeft:设置导航条左侧。可以是按钮或者其他。
- headerStyle:设置导航条的样式。背景色,宽高等。如果想去掉安卓导航条底部阴影可以添加elevation: 0,iOS下用shadowOpacity: 0。
- headerTitleStyle:设置导航条文字样式。安卓上如果要设置文字居中,只要添加alignSelf:'center'就可以了。在安卓上会遇到,如果左边有返回箭头导致文字还是没有居中的问题,最简单的解决思路就是在右边也放置一个空的按钮。
- headerBackTitleStyle:设置导航条返回文字样式。
- headerTintColor:设置导航栏文字颜色。总感觉和上面重叠了。
- headerPressColorAndroid:安卓独有的设置颜色纹理,需要安卓版本大于5.0
- gesturesEnabled:是否支持滑动返回手势,iOS默认支持,安卓默认关闭
-
gestureResponseDistance:对象覆盖触摸从屏幕边缘开始的距离,以识别手势。 它需要以下属性:
horizontal- number - 水平方向的距离 默认为25。
vertical - number - 垂直方向的距离 默认为135。
导航视觉效果
- mode:定义跳转风格。
- card:使用iOS和安卓默认的风格。
- modal:iOS独有的使屏幕从底部画出。类似iOS的present效果
- headerMode:边缘滑动返回上级页面时动画效果。
- float:iOS默认的效果,可以看到一个明显的过渡动画。
- screen:滑动过程中,整个页面都会返回。
- none:没有动画。
- cardStyle:自定义设置跳转效果。
-
transitionConfig: 自定义设置滑动返回的配置。
-
onTransitionStart:当转换动画即将开始时被调用的功能。
-
onTransitionEnd:当转换动画完成,将被调用的功能。
-
path:路由中设置的路径的覆盖映射配置。
**- initialRouteName:设置默认的页面组件,必须是上面已注册的页面组件。
**- initialRouteParams:初始路由的参数。 -
goBack 关闭
-
path:path属性适用于其他app或浏览器使用url打开本app并进入指定页面。path属性用于声明一个界面路径,例如:【/pages/Home】。此时我们可以在手机浏览器中输入:app名称://pages/Home来启动该App,并进入Home界面。
StackNavigator 简单例子 不传参
入口
import React from 'react';
import { StyleSheet, Text, View } from 'react-native';
import SimpleApp from './HomeScreen'
export default class App extends React.Component {
render() {
return <SimpleApp />;
}
}
const styles = StyleSheet.create({
container: {
flex: 1,
backgroundColor: '#fff',
alignItems: 'center',
justifyContent: 'center'
}
});
主页面:HomeScreen
import {
AppRegistry,
Text,
View,
Button,
StyleSheet,
} from 'react-native';
import { StackNavigator } from 'react-navigation';
import React, {Component} from 'react';
import ChatScreen from './ChatScreen'
class HomeScreen extends React.Component {
static navigationOptions = {
title: 'Welcome'
};
render() {
const { navigate } = this.props.navigation;
return(
<View style={styles.container}>
<Button
onPress={() => navigate('Chat')}
title="Chat with Lucy"
/>
</View>
)
}
}
var styles = StyleSheet.create({
container: {
flex: 1,
},
});
export const SimpleApp = StackNavigator({
Home: { screen: HomeScreen },
Chat: { screen: ChatScreen },
});
module.exports = SimpleApp;
跳转的页面ChatScreen
import {
AppRegistry,
Text,
View,
} from 'react-native';
import React, {Component} from 'react';
import { StackNavigator } from 'react-navigation';
class ChatScreen extends React.Component {
// Nav options can be defined as a function of the screen's props:
static navigationOptions = ({navigation}) => ({
title: `Chat with`,
});
render() {
// The screen's current route is passed in to `props.navigation.state`:
// const {params} = this.props.navigation.state;
return (
<View>
<Text>Chat with </Text>
</View>
);
}
}
module.exports = ChatScreen;
网友评论