Facebook力推导航库:React Navigation使用详解

烈酒焚心 提交于 2019-12-09 09:24:23

本文来自Songlcy投稿:文章地址:http://blog.csdn.net/u013718120/article/details/72357698

一、开源库介绍

今年1月份,新开源的react-natvigation库备受瞩目。在短短不到3个月的时间,github上星数已达4000+。Fb推荐使用库,并且在React Native当前最新版本0.44中将Navigator删除。react-navigation据称有原生般的性能体验效果。可能会成为未来React Native导航组件的主流军。本篇内容基于【 ^1.0.0-beta.9 】版本来介绍关于该库的使用和实战技巧。可以看到,虽然是beta版本,不过基本稳定,大家可放心在项目中使用。该库包含三类组件:

刚创建的React Native交流10群:157867561,欢迎各位大牛,React Native技术爱好者加入交流!同时博客右侧欢迎微信扫描关注订阅号,移动技术干货,精彩文章技术推送!

(1)StackNavigator:用来跳转页面和传递参数

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

二、React-Navigation使用

具体内容大致分为如下:

(1)react-navigation库属性介绍

(2)StackNavigator、TabNavigator实现界面间跳转,Tab切换

(3)StackNavigator界面间跳转、传值、取值

(4)DrawerNavigator实现抽屉导航菜单

(5)DrawerNavigator扩展功能

(6)修改源码,定制UI界面

2.1、StackNavigator属性介绍

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
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.2、TabNavigator属性介绍

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
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:图标样式

2.3、DrawerNavigator属性介绍

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
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三种组件的一些基本属性,所以到我们甩起袖子撸代码见证下奇迹了。

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

API定义:StackNavigator(RouteConfigs, StackNavigatorConfig)、TabNavigator(RouteConfigs, TabNavigatorConfig)

(1)集成 react-navigation:在终端执行 【 npm install react-navigation --save 】

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

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

(3)定义TabNavigator:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
const Tab = TabNavigator( 
  
    Home:{ 
      screen:HomeScreen, 
      navigationOptions:({navigation}) => ({ 
        tabBarLabel:'首页'
        tabBarIcon:({focused,tintColor}) => ( 
          <TabBarItem 
            tintColor={tintColor} 
            focused={focused} 
            normalImage={require('./imgs/nav_fav@2x.png')} 
            selectedImage={require('./imgs/nav_fav_actived@3x.png')} 
          /> 
        
      }), 
    }, 
 
    Mine:{ 
          screen:MineScreen, 
          navigationOptions:({navigation}) => ({ 
          tabBarLabel:'我'
          tabBarIcon:({focused,tintColor}) => ( 
            <TabBarItem 
             tintColor={tintColor} 
              focused={focused} 
              normalImage={require('./imgs/tab_me_nor@3x.png')} 
              selectedImage={require('./imgs/tab_me_selected@2x.png')} 
            /> 
          
        }), 
      }, 
    }, 
 
    
      tabBarComponent:TabBarBottom, 
      tabBarPosition:'bottom'
      swipeEnabled:false
      animationEnabled:false
      lazy:true
      tabBarOptions:{ 
        activeTintColor:'#06c1ae'
        inactiveTintColor:'#979797'
        style:{backgroundColor:'#ffffff',}, 
        labelStyle: { 
              fontSize: 20, // 文字大小 
          }, 
      
 
    
 
  );

TabBarItem为封装的组件:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
import React,{Component} from 'react'
import {Image} from 'react-native'
 
export default class TabBarItem extends Component { 
 
    render() { 
        return
            <Image source={ this.props.focused ? this.props.selectedImage : this.props.normalImage } 
                style={ { tintColor:this.props.tintColor,width:25,height:25 } } 
            /> 
        
    
 
}

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

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

(2)设置导航栏的属性参数。

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
const Navigator = StackNavigator( 
 
  
    Tab:{screen:Tab}, 
    Product:{screen:ProductScreen} 
  }, 
 
  
    navigationOptions:{ 
      headerBackTitle:null
      headerTintColor:'#333333'
      showIcon:true
     swipeEnabled:false
     animationEnabled:false
    }, 
 
    mode:'card'
  });

看起来和TabNavigator很相似,同样是指定了两个参数:

(1)指定要跳转的界面组件。同样是screen属性标识界面组件,不多赘述。

(2)定义跳转属性参数,即顶部导航栏的一些参数设置和跳转方式。

可以看到,我们将Tab作为一个界面设置到了StackNavigator。这样就可以实现Tab导航和界面间跳转的效果了。

最后就是在render中引用StackNavigator:

1
2
3
4
5
6
7
8
export default class Demo extends Component { 
 
  render() { 
        return
          <Navigator /> 
        ); 
  
}

StackNavigator还提供了onNavigationStateChange回调方法,用来监听导航状态的改变。具体不再赘述。实现了界面跳转和切换,那么就该来增加下界面之间的感情了,来看看如何实现界面之间的传值和取值。

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

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

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

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

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

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

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

(2)跳转时传值:

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

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

(3)获取值:

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

通过state.params来获取传来的参数,后面为key值。此处为info。
以上实现完成,我们就可以愉快的玩耍啦~~ 什么?忽然发现在Android上的效果和IOS效果不一样。老板要界面一致哇~ 怎么办?那就需要我们进行简单的适配了。

三、DrawerNavigator实现抽屉导航

1、导航实现

API定义:DrawerNavigator(RouteConfigs,DrawerNavigatorConfig)

(1)界面中定义DrawerNavigator:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
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
          <Navigator /> 
        ); 
  
 
const Navigator = DrawerNavigator({ 
 
    Home:{screen:HomeScreen}, 
    Mine:{screen:MineScreen}, 
}); 
 
const styles = StyleSheet.create({ 
 
    container: { 
        flex: 1, 
    }, 
}); 
 
AppRegistry.registerComponent('Demo', () => Demo);

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

(2)HomeScreen界面和MineScreen界面:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
export default class HomePage extends Component { 
 
    static navigationOptions = { 
        drawerLabel: '首页'
        drawerIcon:({tintColor}) => ( 
            <Image 
                source={require('./../imgs/ic_happy.png')} 
                style={[styles.icon, {tintColor: tintColor}]}/> 
        ), 
    }; 
 
    render() { 
        return
            <View style={{flex:1}}> 
                <Text onPress={this._skip.bind(this)}>点击跳转</Text> 
            </View> 
        ); 
    
 
    _skip() { 
        this.props.navigation.navigate("Mine"); 
    
 
export default class MinePage extends Component { 
 
    static navigationOptions = { 
        drawerLabel:'我'
         drawerIcon: ({ tintColor }) => ( 
            <Image 
                source={require('./../imgs/ic_h.png')} 
                style={[styles.icon, {tintColor: tintColor}]} 
            /> 
        ), 
    }; 
 
    render() { 
        return
            <View style={{flex:1}}> 
                <Text onPress={this._skip.bind(this)}>返回上一界面</Text> 
            </View> 
        ); 
    
 
    /** 
     * 跳转 
     */ 
    _skip() { 
        this.props.navigation.goBack(); 
    
}

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

2、扩展功能

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

1
2
3
4
5
  drawerWidth:200, 
  抽屉位置:“对” 
  contentComponent:props => <ScrollView> <DrawerItems {... props} /> </ ScrollView> 
}

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

1
2
3
4
5
6
7
import {DrawerItems} from 'react-navigation'
 
const CustomDrawerContentComponent = (props) => ( 
  <View style = {style.container}> 
    <DrawerItems {... props} /> 
  </View>   
);

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

四、react-navigation源码定制

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

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

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

1
2
3
4
5
6
7
8
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行代码处,修改为如下即可。

1
2
3
4
5
6
7
8
9
{Platform.OS === 'ios' && 
     title && 
     <Text 
       onLayout={this._onTextLayout} 
       style={[styles.title, { color: tintColor }]} 
       numberOfLines={1} 
     
       {backButtonTitle} 
     </Text>}

将上述代码删除即可。

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

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

1
2
3
4
5
6
7
8
9
10
11
12
class demo extends Component { 
 
    static navigationOptions =({navigation})=>({ 
            right:( <Button  onPress={state.params.clickParams}/>) 
    }) 
    _btnClick=()=> { 
     alert('单击'
    }; 
    componentWillMount() { 
       this.props.navigation.setParams({clickParams:this._btnClick}) 
    
}

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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
class demo extends Component { 
    static navigationOptions = ({navigation}) =>({ 
           visible: state.params.headerState , 
    }); 
 
    render(){ 
        return
            <Button 
            title="Hide Header" 
            onPress={() => this.props.navigation.setParams({ headerState : 'none' })} 
        />) 
    
}
五、效果图

抽屉导航:

以上就是我们实战中常用的属性和技巧。具体的操作还需要大家在实践过程中测试体会。

刚创建的React Native交流10群:157867561,欢迎各位大牛,React Native技术爱好者加入交流!同时博客右侧欢迎微信扫描关注订阅号,移动技术干货,精彩文章技术推送!

尊重原创,转载请注明:From Sky丶清(http://www.lcode.org) 侵权必究!

 

引用原文:http://www.lcode.org/facebook-react-navigation/

 

写博客是为了记住自己容易忘记的东西,另外也是对自己工作的总结,文章可以转载,无需版权。希望尽自己的努力,做到更好,大家一起努力进步!

如果有什么问题,欢迎大家一起探讨,代码如有问题,欢迎各位大神指正!

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!