博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
react-navigation
阅读量:6196 次
发布时间:2019-06-21

本文共 9156 字,大约阅读时间需要 30 分钟。

一、开源库介绍

react-navigation据称有原生般的性能体验效果。

该库包含三类组件:

(1)StackNavigator:用来跳转页面和传递参数(2)TabNavigator:类似底部导航栏,用来在同一屏幕下切换不同界面(3)DrawerNavigator:侧滑菜单导航栏,用于轻松设置带抽屉导航的屏幕

 

二、react-navigation使用

具体内容大致分为如下:

(1)react-navigation库属性介绍(2)StackNavigator、TabNavigator实现界面间跳转,Tab切换(3)StackNavigator界面间跳转、传值、取值(4)DrawerNavigator实现抽屉导航菜单(5)DrawerNavigator扩展功能(6)修改源码,定制UI界面

 

1、StackNavigator属性介绍

navigationOptions:配置StackNavigator的一些属性。        title:标题,如果设置了这个导航栏和标签栏的title就会变成一样的,不推荐使用      header:可以设置一些导航的属性,如果隐藏顶部导航栏只要将这个属性设置为null      headerTitle:设置导航栏标题,推荐      headerBackTitle:设置跳转页面左侧返回箭头后面的文字,默认是上一个页面的标题。可以自定义,也可以设置为null      headerTruncatedBackTitle:设置当上个页面标题不符合返回箭头后的文字时,默认改成"返回"      headerRight:设置导航条右侧。可以是按钮或者其他视图控件      headerLeft:设置导航条左侧。可以是按钮或者其他视图控件      headerStyle:设置导航条的样式。背景色,宽高等      headerTitleStyle:设置导航栏文字样式      headerBackTitleStyle:设置导航栏‘返回’文字样式      headerTintColor:设置导航栏颜色      headerPressColorAndroid:安卓独有的设置颜色纹理,需要安卓版本大于5.0      gesturesEnabled:是否支持滑动返回手势,iOS默认支持,安卓默认关闭       screen:对应界面名称,需要填入import之后的页面    mode:定义跳转风格       card:使用iOS和安卓默认的风格       modal:iOS独有的使屏幕从底部画出。类似iOS的present效果    headerMode:返回上级页面时动画效果       float:iOS默认的效果       screen:滑动过程中,整个页面都会返回       none:无动画    cardStyle:自定义设置跳转效果       transitionConfig: 自定义设置滑动返回的配置       onTransitionStart:当转换动画即将开始时被调用的功能       onTransitionEnd:当转换动画完成,将被调用的功能    path:路由中设置的路径的覆盖映射配置    initialRouteName:设置默认的页面组件,必须是上面已注册的页面组件    initialRouteParams:初始路由参数

注:大家可能对于path不太理解。path属性适用于其他app或浏览器使用url打开本app并进入指定页面。path属性用于声明一个界面路径,例如:【/pages/Home】。此时我们可以在手机浏览器中输入:app名称://pages/Home来启动该App,并进入Home界面。

 

2、TabNavigator属性介绍

screen:和导航的功能是一样的,对应界面名称,可以在其他页面通过这个screen传值和跳转。      navigationOptions:配置TabNavigator的一些属性    title:标题,会同时设置导航条和标签栏的title    tabBarVisible:是否隐藏标签栏。默认不隐藏(true)    tabBarIcon:设置标签栏的图标。需要给每个都设置    tabBarLabel:设置标签栏的title。推荐    导航栏配置    tabBarPosition:设置tabbar的位置,iOS默认在底部,安卓默认在顶部。(属性值:'top','bottom')    swipeEnabled:是否允许在标签之间进行滑动    animationEnabled:是否在更改标签时显示动画    lazy:是否根据需要懒惰呈现标签,而不是提前,意思是在app打开的时候将底部标签栏全部加载,默认false,推荐为true    trueinitialRouteName: 设置默认的页面组件    backBehavior:按 back 键是否跳转到第一个Tab(首页), none 为不跳转    tabBarOptions:配置标签栏的一些属性iOS属性    activeTintColor:label和icon的前景色 活跃状态下    activeBackgroundColor:label和icon的背景色 活跃状态下    inactiveTintColor:label和icon的前景色 不活跃状态下    inactiveBackgroundColor:label和icon的背景色 不活跃状态下    showLabel:是否显示label,默认开启 style:tabbar的样式    labelStyle:label的样式安卓属性    activeTintColor:label和icon的前景色 活跃状态下    inactiveTintColor:label和icon的前景色 不活跃状态下    showIcon:是否显示图标,默认关闭    showLabel:是否显示label,默认开启 style:tabbar的样式    labelStyle:label的样式 upperCaseLabel:是否使标签大写,默认为true    pressColor:material涟漪效果的颜色(安卓版本需要大于5.0)    pressOpacity:按压标签的透明度变化(安卓版本需要小于5.0)    scrollEnabled:是否启用可滚动选项卡 tabStyle:tab的样式    indicatorStyle:标签指示器的样式对象(选项卡底部的行)。安卓底部会多出一条线,可以将height设置为0来暂时解决这个问题    labelStyle:label的样式    iconStyle:图标样式

 

3、DrawerNavigator属性介绍

DrawerNavigatorConfig                drawerWidth - 抽屉的宽度          drawerPosition - 选项是左或右。 默认为左侧位置          contentComponent - 用于呈现抽屉内容的组件,例如导航项。 接收抽屉的导航。 默认为DrawerItems          contentOptions - 配置抽屉内容                initialRouteName - 初始路由的routeName          order - 定义抽屉项目顺序的routeNames数组。          路径 - 提供routeName到路径配置的映射,它覆盖routeConfigs中设置的路径。          backBehavior - 后退按钮是否会切换到初始路由? 如果是,设置为initialRoute,否则为none。 默认为initialRoute行为               DrawerItems的contentOptions属性                activeTintColor - 活动标签的标签和图标颜色          activeBackgroundColor - 活动标签的背景颜色          inactiveTintColor - 非活动标签的标签和图标颜色          inactiveBackgroundColor - 非活动标签的背景颜色          内容部分的样式样式对象          labelStyle - 当您的标签是字符串时,要覆盖内容部分中的文本样式的样式对象

 

从上述中大致了解了react-navigation三种组件的一些基本属性。

 

4、使用StackNavigator + TabNavigator实现Tab界面切换、界面间导航

API定义:

  StackNavigator(RouteConfigs, StackNavigatorConfig)、

  TabNavigator(RouteConfigs, TabNavigatorConfig)

(1)集成 react-navigation:在终端执行

npm install react-navigation --save

(2)界面中导入必要组件:

import {StackNavigator,TabNavigator,TabBarBottom} from 'react-navigation';  import HomeScreen from './pages/HomePage';  import MineScreen from './pages/MinePage';

(3)定义TabNavigator:

const Tab = TabNavigator(    {      Home:{        screen:HomeScreen,        navigationOptions:({navigation}) => ({          tabBarLabel:'首页',          tabBarIcon:({focused,tintColor}) => (            
) }), }, Mine:{ screen:MineScreen, navigationOptions:({navigation}) => ({ tabBarLabel:'我', tabBarIcon:({focused,tintColor}) => (
) }), }, }, { tabBarComponent:TabBarBottom, tabBarPosition:'bottom', swipeEnabled:false, animationEnabled:false, lazy:true, tabBarOptions:{ activeTintColor:'#06c1ae', inactiveTintColor:'#979797', style:{backgroundColor:'#ffffff',}, labelStyle: { fontSize: 20, // 文字大小 }, } });

  

TabBarItem为封装的组件:

import React,{Component} from 'react';  import {Image} from 'react-native';    export default class TabBarItem extends Component {  render() {      return(              )    }    }

 

可以看到,我们定义了一个名称为【Tab】的TabNavigator的导航组件。在组件中,分为两层参数:

(1)第一层参数定义了要切换的界面,即【首页】、【我】两个界面组件,通过screen属性指定。并且通过navigationOptions属性设置相关属性参数。
(2)设置导航栏的属性参数。

 

TabNavigator定义好之后,需要用StackNavigator,顾名思义,StackNavigator就是以栈的方式来存放整个界面的,而TabNavigator是作为一个界面内不同子界面之间切换。

StackNavigator:

const Navigator = StackNavigator(       {      Tab:{screen:Tab},      Product:{screen:ProductScreen}    },  {      navigationOptions:{        headerBackTitle:null,        headerTintColor:'#333333',        showIcon:true,        swipeEnabled:false,        animationEnabled:false,      },    mode:'card',    });

StackNavigator还提供了onNavigationStateChange回调方法,用来监听导航状态的改变。

 

5、界面间跳转、传值、取值 

在界面组件注入到StackNavigator中时,界面组件就被赋予了navigation属性,即在界面组件中可以通过【this.props.navigation】获取并进行一些操作。

navigation属性中提供了很多的函数简化界面间操作,简单列举几点:

(1)通过navigate函数实现界面之间跳转:

this.props.navigation.navigate('Mine');

参数为我们在StackNavigator注册界面组件时的名称。同样也可以从当前页面返回到上一页:

// 返回上一页  this.props.navigation.goBack();

 

(2)跳转时传值:

this.props.navigation.navigate('Mine',{info:'传值过去'});

第一个参数同样为要跳转的界面组件名称,第二个参数为要传递的参数,info可以理解为key,后面即传递的参数。

 

(3)获取值:

{this.props.navigation.state.params.info}

 

三、DrawerNavigator实现抽屉导航

1、导航实现

API定义:

  DrawerNavigator(RouteConfigsDrawerNavigatorConfig

(1)界面中定义DrawerNavigator:

import {StackNavigator,TabNavigator,DrawerNavigator} from 'react-navigation';  import HomeScreen from './pages/HomePage';  import MineScreen from './pages/MinePage';    export default class Demo extends Component {  render() {      return (        
); } } const Navigator = DrawerNavigator({ Home:{screen:HomeScreen}, Mine:{screen:MineScreen}, }); const styles = StyleSheet.create({ container: { flex: 1, }, }); AppRegistry.registerComponent('Demo', () => Demo);

定义方式和StackNavigator基本类似,不再赘述。

 

(2)HomeScreen界面和MineScreen界面:

export default class HomePage extends Component {  static navigationOptions = {      drawerLabel: '首页',      drawerIcon:({tintColor}) => (            ),    };    render() {      return(        
点击跳转
); } _skip() { this.props.navigation.navigate("Mine"); }} export default class MinePage extends Component { static navigationOptions = { drawerLabel:'我', drawerIcon: ({ tintColor }) => ( ), }; render() { return(
返回上一界面
); } /** * 跳转 */ _skip() { this.props.navigation.goBack(); } }

代码很简单,实现了界面之间的跳转。

 

2、扩展功能

 

(1)默认DrawerView不可滚动。要实现可滚动视图,必须使用contentComponent自定义容器,如下所示:

{    drawerWidth:200,    抽屉位置:“对”    contentComponent:props => 
}

 

(2)可以覆盖导航使用的默认组件,使用DrawerItems自定义导航组件:

import {DrawerItems} from 'react-navigation';        const CustomDrawerContentComponent = (props) => (    
);

 

(3)嵌套抽屉导航

如果您嵌套DrawerNavigation,抽屉将显示在父导航下方。

 

四、react-navigation源码定制

(1)适配顶部导航栏标题:

 测试中发现,在iphone上标题栏的标题为居中状态,而在Android上则是居左对齐。所以需要我们修改源码,进行适配。

【node_modules -- react-navigation -- src -- views -- Header.js】的326行代码处,修改为如下:

title: {    bottom: 0,    left: TITLE_OFFSET,    right: TITLE_OFFSET,    top: 0,    position: 'absolute',    alignItems: 'center',}

 

(2)去除返回键文字显示:

【node_modules -- react-navigation -- src -- views -- HeaderBackButton.js】的91行代码处,修改为如下即可。

{Platform.OS === 'ios' &&    title &&    
{backButtonTitle}
}

将上述代码删除即可。

 

(3)设置标题栏的按钮单击事件:

因为在界面组件中设置标题参数时,需要将navigationOptions定义成static。所以我们不能直接通过this.xxx.bind(this)来调用自定义函数,怎么办呢?可以通过如何方式解决:

class demo extends Component {       static navigationOptions =({navigation})=>({      right:( 

 

(4)动态设置标题栏显示和隐藏

根据(3)中的思想,我们可以利用setParams来动态修改状态栏的显示和隐藏:

class demo extends Component {    static navigationOptions = ({navigation}) =>({      visible: state.params.headerState,    });    render(){      return(        

 

参考:http://www.cnblogs.com/gdsblog/p/7358400.html

.

 

转载于:https://www.cnblogs.com/crazycode2/p/7496570.html

你可能感兴趣的文章
命令行获取当前日期及时间
查看>>
Ruby 类案例
查看>>
asp.net中xml的简单增删改
查看>>
[转]python3之日期和时间
查看>>
Python学习之路11——面向对象
查看>>
json转sql
查看>>
拷贝构造函数
查看>>
多线程基础——线程启动
查看>>
C语言位运算(一)(转)
查看>>
基于云计算感应器的智能盆栽监测系统
查看>>
【405】算法时间复杂度和空间复杂度的计算
查看>>
MYSQL 加密的 3 类方法
查看>>
favicon.ico 404
查看>>
探秘Java中String、StringBuilder以及StringBuffer
查看>>
ActivityGroup中EditText无法删除的问题
查看>>
android 修改系统的dialog样式
查看>>
Spring+SpringMVC+MyBatis深入学习及搭建(五)——动态sql
查看>>
Codeforces Round #306 (Div. 2) A B C
查看>>
面向对象设计:共性VS个性-------继承的粒度和聚合的粒度以及类的重构
查看>>
计算机操作系统总结
查看>>