React Native之ViewPagerAndroid 组件

概述

今天我们来讲解一下关于 ViewPager 的使用，它是一个允许子视图左右滚动翻页的容器。我们知道在Android开发中系统有ViewPager这个组件，作用是实现滚动翻页的，在RN中也是有这么一个组件的（ViewPagerAndroid），每一个ViewPagerAndroid的子容器会被视作一个单独的页，并且会被拉伸填满ViewPagerAndroid。

我们来看一段官方给出的例子：

render: function() {
return (
<ViewPagerAndroid
style={styles.viewPager}
initialPage={0}>
<View style={styles.pageStyle}>
<Text>First page</Text>
</View>
<View style={styles.pageStyle}>
<Text>Second page</Text>
</View>
</ViewPagerAndroid>
);
}

...

var styles = {
...
pageStyle: {
alignItems: 'center',
padding: 20,
}
}

写法很简单，通过标签来包裹控件，然后里面添加相应的属性。

ViewPagerAndroid属性

initialPage number 顾名思义：初始索引页，当然我们也可以通过 setPage 函数来翻页，还可以通过 onPageSelected 方法来监听页面的滑动。
keyboardDismissMode enum(‘none’, “on-drag”) 这个还是很人性化的，就是监听在滑动的时候是否隐藏软键盘。

none ： 默认值，意思是不会隐藏消失
on-drag ： 当拖拽滑动时软键盘消失
onPageScroll function 当在页面间滑动切换时（不管是动画还是由于用户在页间滑动或者拖拽）执行。
回调参数中的event.nativeEvent对象会包含如下数据：

position 从左数起第一个当前可见的页面的下标。
offset 一个在[0,1)（大于等于0，小于1）之间的范围，代表当前页面切换的状态。值x表示现在”position”所表示的页有(1 - x)的部分可见，而下一页有x的部分可见。]
onPageScrollStateChanged function 顾名思义：当页面滑动状态变化时调用这个函数，页面滑动的状态有三种：

idle ： 无交互时，空闲状态
dragging ： 拖拽滑动中，意思是页面正在拖拽当中
settling ： 处理中，意味着当前页面发生过交互，且正在结束开头或收尾的动画。
onPageSelected function 上面我们提到过，这个函数是当页面切换完成后调用。该方法回调参数中的event.nativeEvent对象会携带一个属性 : ‘position’ 。该属性代表当前选中的页面的索引值。scrollEnabled bool 布尔值，true是默认是，可以滑动，false代表禁止滚动。

ViewPagerAndroid实例

为了更好的理解，我们自己实现一个实例，效果如下：

import React, { Component } from 'react';
import {
AppRegistry,
StyleSheet,
Text,
ViewPagerAndroid,
TouchableOpacity,
Image,
View
} from 'react-native';
var PAGES = 2;
var IMAGE_URIS = [
'http://apod.nasa.gov/apod/image/1410/20141008tleBaldridge001h990.jpg',
'http://apod.nasa.gov/apod/image/1409/volcanicpillar_vetter_960.jpg',
];
export default class ViewPagerDemo extends Component {
state={
page:0,
};
render() {
var pages = [];
for(let i = 0;i < PAGES;i++){
pages.push(
<View key={i} collapsable={false}>
<TouchableOpacity
activeOpacity={1}
onPress={this.onPress}
>
<Image
style={styles.image}
source={{uri:IMAGE_URIS[i]}}>
</Image>
</TouchableOpacity>
</View>
);
}
return (
<View style={styles.container}>
<ViewPagerAndroid style={styles.viewPager}
initialPage={0}
onPageSelected={this.onPageSelected}
>
{pages}
</ViewPagerAndroid>
<Text style={{flex:1,alignSelf:'center'}}>当前第{this.state.page+1}页</Text>
</View>
);
}
onPageSelected=(e)=>{
this.setState({page:e.nativeEvent.position});
}
onPress=()=>{
alert('第'+(this.state.page+1)+'页被点击了');
}
}
const styles = StyleSheet.create({
container: {
flex: 1,
backgroundColor: '#F5FCFF',
},
image: {
height: 200,
padding: 20,
},
viewPager: {
flex: 1,
},
});
AppRegistry.registerComponent('ViewPagerDemo', () => ViewPagerDemo);