【React Native】文件翻譯閱讀紀錄 - Components(組件) - ViewPagerAndroid
Facebook Open Source React Native |
ViewPagerAndroid
允許在子視圖之間左右翻轉的容器。 ViewPagerAndroid的每個子視圖都將被視為一個單獨的頁面,並將被拉伸以填充ViewPagerAndroid。
重要的是所有孩子都是<View>而不是複合組件。您可以為每個子項設置樣式屬性,如填充或backgroundColor。每個孩子都有一個關鍵的道具也很重要。
例:
重要的是所有孩子都是<View>而不是複合組件。您可以為每個子項設置樣式屬性,如填充或backgroundColor。每個孩子都有一個關鍵的道具也很重要。
例:
render: function() {
return (
<ViewPagerAndroid
style={styles.viewPager}
initialPage={0}>
<View style={styles.pageStyle} key="1">
<Text>First page</Text>
</View>
<View style={styles.pageStyle} key="2">
<Text>Second page</Text>
</View>
</ViewPagerAndroid>
);
}
...
var styles = {
...
viewPager: {
flex: 1
},
pageStyle: {
alignItems: 'center',
padding: 20,
}
}
Props
initialPage
keyboardDismissMode
onPageScroll
onPageScrollStateChanged
onPageSelected
pageMargin
peekEnabled
scrollEnabled
setPage
setPageWithoutAnimation
Type Definitions
參考
Props
initialPage
應選擇的初始頁面的索引。使用setPage方法更新頁面,使用onPageSelected監視頁面更改
TYPE | REQUIRED |
---|---|
number | No |
keyboardDismissMode
確定鍵盤是否因響應拖動而被解除。
- 'none' (the default), drags不會關閉鍵盤。
- 'on-drag',當拖動開始時鍵盤被解除。
TYPE | REQUIRED |
---|---|
enum('none', 'on-drag') | No |
onPageScroll
在頁面之間轉換時執行(由於所請求頁面更改的動畫或用戶在頁面之間滑動/拖動時為以太)此回調的event.nativeEvent對象將攜帶以下數據:
- position - 當前可見的左側第一頁的索引
- offset - 描述頁面轉換之間階段的範圍[0,1)的值。值x表示“位置”索引處的頁面的(1-x)部分是可見的,並且下一頁的x部分是可見的。
TYPE | REQUIRED |
---|---|
function | No |
onPageScrollStateChanged
頁面滾動狀態更改時調用的函數。頁面滾動狀態可以是3種狀態:
- idle, 意味著當時沒有與頁面滾動器發生交互
- dragging, 意味著當前存在與頁面滾動器的交互
- settling, 意味著與頁面滾動器進行了交互,頁面滾動器現在正在完成它的關閉或打開動畫
onPageSelected
一旦ViewPager完成導航到所選頁面(當用戶在頁面之間滑動時),將調用此回調。傳遞給此回調的event.nativeEvent對象將包含以下字段:
- position - 已選擇的頁面索引
TYPE | REQUIRED |
---|---|
function | No |
pageMargin
頁面之間顯示的空白區域。這僅在滾動時可見,頁面仍然是邊對邊的。
TYPE | REQUIRED |
---|---|
number | No |
peekEnabled
是否啟用顯示peekFraction。如果是這樣,則上一頁和下一頁的預覽將顯示在當前屏幕中。默認為false。
TYPE | REQUIRED |
---|---|
bool | No |
scrollEnabled
如果為false,則內容不會滾動。默認值是true。
TYPE | REQUIRED |
---|---|
bool | No |
setPage
一個幫助函數,用於滾動到ViewPager中的特定頁面。頁面之間的過渡將是動畫的。
- position - 將被選擇的頁面索引
TYPE | REQUIRED |
---|---|
Number | Yes |
setPageWithoutAnimation
一個幫助函數,用於滾動到ViewPager中的特定頁面。頁面之間的過渡不會動畫。
- position - 將被選擇的頁面索引
TYPE | REQUIRED |
---|---|
Number | Yes |
Type Definitions
ViewPagerScrollState
TYPE |
---|
$Enum |
Constants:
VALUE | DESCRIPTION |
---|---|
idle | |
dragging | |
settling |
0 意見