title: 翻译|React-navigation导航系统(6)-Views
date: 2017-03-30 14:04:48
categories: 翻译
tags: React-Native
Views
Navigation 视图是接受router和navigaion 的prop的表征组件,通过navigation.state的设定,可以显示几个screens.
Navigation view是被控制的React组件,表征当前的navigation state.他们管理screen之间的切换,动画和手势.他们也持久化navigation view例如tab bars和headers
内建的Views
-
CardStack-代表stack在任何平台上都匹配
- 代表一个从Card stack来的card.
- Header-card stack的header view
Tabs-tab切换器/页面的配置
Drawer-从左侧滑出的Drawer的view
Transitioner
transitioner是一个React 组件帮助管理复杂动画组件之间演变的工具.它管理动画的时间调度,保留各种screen的进入离开的记录,但是它不知道具体的事件是什么,应为具体的渲染过程委托给了开发者.
在内部,Transitioner被用来实施CardStack,因此是StackNavigator.
Transiioner最有用的用途是接受当前navigation的state.当routes从navigation state移除的时候,Transitioner
实例
class MyNavView extends Component {
...
render() {
return (
<Transitioner
configureTransition={this._configureTransition}
navigation={this.props.navigation}
render={this._render}
onTransitionStart={this.onTransitionStart}
onTransitionEnd={this.onTransitionEnd}
/>
);
}
Props
configureTransitionfunction
被Transitioner.componentWillReceiveProps,这个函数允许定制动画的参数,例如延续时间.这个函数返回的值将会传递进入时间序列函数,默认是Animated.timing().
Examples
_configureTransition(transitionProps, prevTransitionProps) {
return {
// duration in milliseconds, default: 250
duration: 500,
// An easing function from `Easing`, default: Easing.inOut(Easing.ease)
easing: Easing.bounce,
}
}
注意:duration和easing只用当时间序列函数是Animated.timing的时候才可以应用.我们可以根据不同的config参数来使用不同的时间函数.
_configureTransition(transitionProps, prevTransitionProps) {
return {
// A timing function, default: Animated.timing.
timing: Animated.spring,
// Some parameters relevant to Animated.spring
friction: 1,
tension: 0.5,
}
}
Flow definition
configureTransition: (
transitionProps: NavigationTransitionProps,
prevTransitionProps: ?NavigationTransitionProps,
) => NavigationTransitionSpec,
Parameters
-
transitionProps:有当前的navigation state和props创建的当前NavigationTransitionProps -
prevTransitionProps:从前一个navigation stae和props创建的前一个NavigationTransitionProps
Returns
- NavigationTransitionSpec类型的对象,作为参数传递进动画时间序列函数
navigationState对象
代表navigation state的简单对象
实例值
{
// Index refers to the active child route in the routes array.
index: 1,
routes: [
{ key: 'DF2FGWGAS-12', routeName: 'ContactHome' },
{ key: 'DF2FGWGAS-13', routeName: 'ContactDetail', params: { personId: 123 } }
]
}
Flow definition
export type NavigationState = {
index: number,
routes: Array<NavigationRoute>,
};
了解更多的NavigationRoute的类型,查看flow definition
render函数
由Transition.render()调用.这个函数代理了Transitioner的实际渲染功能.在这个函数中,我们可以使用包含在transitionProps和prevTransitionProps中的参数来渲染scene,创建动画和处理手势操作.
transitionProps和prevTransitionProps有一些重要的属性对于上面提到的一些任务是十分有用的.
-
scenes:Array<NavigationScene>-可以使用的scenes的列表 -
position:NavigationAnimation- transitioner的navigation state的进度索引 -
progress:NavigationAnimationedValue-当navigation state从一个转变到另一的时候,这个值代表了演变的进度.从0-1的数值
查看完整的NavigationTransitionProps的属性列表.查看看flow definition
实例
transitionProps.scenes是可以使用的scenes的列表.这个列表依赖于实施者准备怎么来列出screen.例如,可以像下面的代码来渲染cards的堆栈
_render(transitionProps, prevTransitionProps) {
const scenes = transitionProps.scenes.map(scene => this._renderScene(transitionProps, scene));
return (
<View style={styles.stack}>
{scenes}
</View>
);
}
我们可以使用Animated.View去执行演变动画.为了创建必要的动画样式属性,例如透明度,我们可以在position和progress中利用transitionProps来插值.
_renderScene(transitionProps, scene) {
const { position } = transitionProps;
const { index } = scene;
const opacity = position.interpolate({
inputRange: [index-1, index, index+1],
outputRange: [0, 1, 0],
});
// The prop `router` is populated when we call `createNavigator`.
const Scene = this.props.router.getComponent(scene.route.routeName);
return (
<Animated.View style={{ opacity }}>
{ Scene }
</Animated.View>
)
}
上面的代码创建交叉渐隐的动画.
深入理解如何创建定制的transitions,看看这个博客帖子
Flow definition
render: (transitionProps: NavigationTransitionProps, prevTransitionProps: ?NavigationTransitionProps) => React.Element<*>,
参数
-
transitionProps:从当前state和props创建的NavigationTransitionProps. -
prevTransitionProps:从之前的state和props创建的先前NavigationTransitionProps
Returns
- React元素,用来渲染Transitioner 组件
onTransitionEnd函数
动画演变完成后调用一次.
Flow definition
onTransitionEnd: () => void
参数
- none
Returns
- none
