• React Native未来导航者:react-navigation 使用详解


    该库包含三类组件:

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

    (2)TabNavigator:类似底部导航栏,用来在同一屏幕下切换不同界面

    (3)DrawerNavigator:侧滑菜单导航栏,用于轻松设置带抽屉导航的屏幕

    react-navigation使用

     

    具体内容大致分为如下:

    (1)react-navigation库属性介绍

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

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

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

    (5)DrawerNavigator扩展功能

    (6)自定义react-navigation

    1、StackNavigator属性介绍

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

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

    2、TabNavigator属性介绍

     1 screen:和导航的功能是一样的,对应界面名称,可以在其他页面通过这个screen传值和跳转。  
     2   
     3   
     4 navigationOptions:配置TabNavigator的一些属性  
     5   
     6 title:标题,会同时设置导航条和标签栏的title  
     7   
     8 tabBarVisible:是否隐藏标签栏。默认不隐藏(true)  
     9   
    10 tabBarIcon:设置标签栏的图标。需要给每个都设置  
    11   
    12 tabBarLabel:设置标签栏的title。推荐  
    13   
    14 导航栏配置  
    15   
    16 tabBarPosition:设置tabbar的位置,iOS默认在底部,安卓默认在顶部。(属性值:'top''bottom'17   
    18 swipeEnabled:是否允许在标签之间进行滑动  
    19   
    20 animationEnabled:是否在更改标签时显示动画  
    21   
    22 lazy:是否根据需要懒惰呈现标签,而不是提前,意思是在app打开的时候将底部标签栏全部加载,默认false,推荐为true  
    23   
    24 trueinitialRouteName: 设置默认的页面组件  
    25   
    26 backBehavior:按 back 键是否跳转到第一个Tab(首页), none 为不跳转  
    27   
    28 tabBarOptions:配置标签栏的一些属性iOS属性  
    29   
    30 activeTintColor:label和icon的前景色 活跃状态下  
    31   
    32 activeBackgroundColor:label和icon的背景色 活跃状态下  
    33   
    34 inactiveTintColor:label和icon的前景色 不活跃状态下  
    35   
    36 inactiveBackgroundColor:label和icon的背景色 不活跃状态下  
    37   
    38 showLabel:是否显示label,默认开启 style:tabbar的样式  
    39   
    40 labelStyle:label的样式安卓属性  
    41   
    42 activeTintColor:label和icon的前景色 活跃状态下  
    43   
    44 inactiveTintColor:label和icon的前景色 不活跃状态下  
    45   
    46 showIcon:是否显示图标,默认关闭  
    47   
    48 showLabel:是否显示label,默认开启 style:tabbar的样式  
    49   
    50 labelStyle:label的样式 upperCaseLabel:是否使标签大写,默认为true  
    51   
    52 pressColor:material涟漪效果的颜色(安卓版本需要大于5.053   
    54 pressOpacity:按压标签的透明度变化(安卓版本需要小于5.055   
    56 scrollEnabled:是否启用可滚动选项卡 tabStyle:tab的样式  
    57   
    58 indicatorStyle:标签指示器的样式对象(选项卡底部的行)。安卓底部会多出一条线,可以将height设置为0来暂时解决这个问题  
    59   
    60 labelStyle:label的样式  
    61   
    62 iconStyle:图标样式  

    3、DrawerNavigator属性介绍

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

    TabBarItem为封装的组件:

    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,25,height:25 } }  
                />  
            )  
        }  
          
    }  

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

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

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

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

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

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

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

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

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

    最后就是在render中引用StackNavigator:

    export default class Demo extends Component {  
      
      render() {  
            return (  
              <Navigator />  
            );  
      }  
    }  

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


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

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

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

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

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

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

    (2)跳转时传值:

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

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

    (3)获取值:

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

    通过state.params来获取传来的参数,后面为key值。此处为info。

    以上实现完成,我们就可以愉快的玩耍啦~~ 什么?忽然发现在Android上的效果和IOS效果不一样。老板要界面一致哇~ 怎么办?那就需要我们进行简单的适配了。

    三、DrawerNavigator实现抽屉导航


    1、导航实现

    API定义:DrawerNavigator(RouteConfigs,DrawerNavigatorConfig)

    (1)界面中定义DrawerNavigator:

     1 import {StackNavigator,TabNavigator,DrawerNavigator} from 'react-navigation';  
     2 import HomeScreen from './pages/HomePage';  
     3 import MineScreen from './pages/MinePage';  
     4   
     5 export default class Demo extends Component {  
     6   
     7   render() {  
     8         return (  
     9           <Navigator />  
    10         );  
    11   }  
    12 }  
    13   
    14 const Navigator = DrawerNavigator({  
    15   
    16     Home:{screen:HomeScreen},  
    17     Mine:{screen:MineScreen},  
    18 });  
    19   
    20 const styles = StyleSheet.create({  
    21   
    22     container: {  
    23         flex: 1,  
    24     },  
    25 });  
    26   
    27 AppRegistry.registerComponent('Demo', () => Demo);  

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

    (2)HomeScreen界面和MineScreen界面:

     
    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自定义容器,如下所示:

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

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

     
    import {DrawerItems} from 'react-navigation';  
      
    const CustomDrawerContentComponent = (props) => (  
      <View style = {style.container}>  
        <DrawerItems {... props} />  
      </View>    
    );  

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

  • 相关阅读:
    Silverlight Tips(2)
    Sl4程序部署至IIS7
    Silverlight Tips(1)
    Silverlight中使用MVVM(5):Command II
    Linq操作之Except,Distinct,Left Join
    Ubuntu搭建Django+Flup+Nginx环境
    ASP.NET 4.0 与 Entity Framework 4第四篇Entity Framework在三层架构中的使用
    玩转博客园的5个小技巧
    Linux下安装Django1.2和MysqlPython
    Linux下如何给Subversion和Mercurial设置HTTP代理
  • 原文地址:https://www.cnblogs.com/haonanZhang/p/7551570.html
Copyright © 2020-2023  润新知