StackNavigator

2017-09-28  本文已影响0人  lmy2534290808

StackNavigator

为你的应用程序提供一种在两屏幕之间切换的方法,每一个新的屏幕都会放在栈的顶部。

默认情况下,StackNavigator配置为具有熟悉的iOS和Android外观:iOS上的新屏幕从右侧滑出,从Android的底部渐入。在iOS上,StackNavigator也可以配置为modal样式,屏幕从底部滑入


例如:

class MyHomeScreen extends React.Component {
  static navigationOptions = {
    title: 'Home',
  }

  render() {
    return (
      <Button
        onPress={() => this.props.navigation.navigate('Profile', {name: 'Lucy'})}
        title="Go to Lucy's profile"
      />
    );
  }
}

const ModalStack = StackNavigator({
  Home: {
    screen: MyHomeScreen,
  },
  Profile: {
    path: 'people/:name',
    screen: MyProfileScreen,
  },
});

API

StackNavigator(RouteConfigs, StackNavigatorConfig)

RouteConfigs

路由配置和路由名称的一种映射,告诉navigator按照该路由要呈现什么

StackNavigator({
  //Home界面route
  Home:{
    //require  Homescreen就是一个react的组件(component),用来展示的那个界面
    screen:HomeScreen,//当HomeScreen加载完成后,他会得到一个navigation属性
    //optional   当深层次关联或者在web app中使用React Navigation,使用路径
    path:'people/:username',
    //optional Override navigationOptions方法,对navigator做一些配置
    navigationOptions:{
      //设置个标题
      title:({state}) => `${state.params.username}'s Profile'`
    },
  },

  //我的其他路由,类似于上面这种定义模式的,供给navigator实现页面见得跳转
  ...MyOtherRoutes,
)}

StackNavigatorConfig

option for the route(路由选项):
  initialRouteName:为stack设置默认的界面,必须和route configs里面的一个key匹配。
  initialRouteParams: 初始路由的参数。
  navigationOptions:屏幕导航的默认选项。
  paths: routeconfig里面路径设置的映射。

Visual Option(视觉选项):
  mode: 定义渲染(rendering)和转换(transitions)的模式,两种选项(给字符串即可):
     card:使用标准的iOS和Android的界面切换,这是默认的。
     modal:仅在iOS端有用,即模态出该视图。
  headerMode: 指定header应该如何被渲染,选项:
     float: 共用一个header 意思就是有title文字渐变效果。ios常见模式
     screen: 各用各的header 意思就是没有title文字渐变效果。Android常见模式
     none:  没有header。
  cardStyle: 使用该属性继承或者重载一个在stack中的card的样式。
  onTransitionStart: 一个函数,在换场动画开始的时候被激活。
  onTransitionEnd: 一个函数,在换场动画结束的时候被激活

Screen Navigation Options

通常你可以定义一个静态的navigationOptions在你的组件之上

title:string 可用作headerTitle、tabBarLabel
header:React element或一个给出HeaderProps参数、返回React element的函数,null则隐藏Header
headerTitle:string或者React element,默认是title的值,
headerBackTitle:iOS上的后退按钮使用的标题字符串,或禁用标签,默认为上一个scene的headerTtile
headerTruncatedBackTitle:当headerBackTtile不适应screen是使用,默认为'Back',
headerRight:React element,显示在header右侧,
headerLeft:React element,显示在header左侧,
headerStyle:header的样式,
headerTitleStyle:headerTitle的样式,
headerBackTitleStyle:headerBackTitle的样式,
headerTintColor:android上的返回icon可用此设置,
headerPressColorAndroid:material波纹颜色 Android>=5.0有效,
gesturesEnabled:是否可以使用手势关闭此屏幕。在iOS上默认为true,在Android上为false,

Navigator Props

通过StackNavigator()创建的导航组件可带有screenProps属性
例如:

const SomeStack = StackNavigator({
  // config
});

<SomeStack
  screenProps={/* this prop will get passed to the screen components as this.props.screenProps */}
/>
Ex
上一篇下一篇

猜你喜欢

热点阅读