ViewPager 类
继承 View
一个可自动滚动可翻页的控件
该控件提供了无限滚动,自动滚动,手动切换页面等功能,更可以同TabSegment控件进行联动,开发出复杂的联动效果
变量
_priveta_class_name : string
name : string
方法
adapter
设置数据和事件的适配器
在创建完适配器后,通过该方法绑定到ViewPager控件上
@note 鉴于设置adapter时会触发刷新,尽量初始化完毕后再进行设置
参数
- adapter : ViewPagerAdapter 负责页面初始化以及事件回传
返回值
adapter
获取当前控件所绑定的适配器
获取已经绑定的adapter对象
返回值
- 返回一个ViewPagerAdapter实例对象 : ViewPagerAdapter
autoScroll
控制是否开启自动滚动
控制是否开启自动滚动,开启后ViewPager会自动滚动。未开启无限滚动时,ViewPager滚动到最后一页后会返回第一页重新开始。开启无限滚动后,ViewPager页面会自动无限滚动
参数
- enable : boolean 是否开启自动滚动
返回值
autoScroll
获取当前设置的自动滚动状态
返回值
- 返回布尔值 : boolean
recurrence
设置是否循环滚动,默认为false
设置是否开启循环滚动,开启后同方向可以无限循环滚动。当绑定TabSegmentView控件后,不能无限循环滚动
@note 绑定了TabSegmentView后不可用。状态修改后,一定要reloadData
参数
- enable : boolean 是否开启循环滚动
返回值
recurrence
获取当前循环滚动状态
返回值
- : boolean
frameInterval
设置自动滚动的时间间隔,默认为2s
参数
- time : number 单位s
返回值
frameInterval
获取自动滚动的时间间隔
返回值
- 单位s : number
showIndicator
控制是否展示指示器
控制器滚动指示器的展示和隐藏,默认为true展示
参数
- show : boolean 是否展示指示器
返回值
showIndicator
获取指示器的状态
获取当前指示器的展示状态,true为展示
返回值
- 布尔值 : boolean
aheadLoad
控制是否开启预加载
控制是否开启预加载,提前加载上一页和下一页
参数
- open : boolean 是否开启预加载
返回值
aheadLoad
获取是否开启预加载
获取是否开始了预加载
返回值
- 布尔值 : boolean
endDragging
page页结束滚动时回调
设置page页结束滚动时的回调,会回调结束滚动时的页面位置
回调格式:
```
function(number position)
---position:结束滚动的page页在ViewPager的位置
end
```
@note 索引从1开始
参数
- callback : function(position)
返回值
onChangeSelected
滑动后选中具体页面位置回调
回调格式:
```
function(number position)
---position:结束滚动的page页在ViewPager的位置
end
```
@note 如果还是在当前Page页面,则不会回调,只有页面position发生变化后才会回调
参数
- callback : function(position)
返回值
reloadData
刷新所有的数据
用来刷新当前控件的所有数据
返回值
scrollToPage
滚动到某页
滚动到某页,可以控制是否在滚动过程中执行动画
参数
- position : number 页面坐标
- animated : boolean 是否开启动画
返回值
currentPageColor
设置指示器当前帧的颜色
设置指示器当前帧的颜色
参数
- color : Color 颜色
返回值
pageDotColor
设置指示器默认点的颜色
设置指示器默认点的颜色
参数
- color : Color 颜色
返回值
currentPage
获取ViewPager当前页的页数
返回值
- 页数 : number
setPreRenderCount
设置预加载页面数量
设置预加载页面数量,Android专用,iOS空实现,默认为1:左右各预加载一页,0:不预加载
@note Android专用
参数
- count : number 预加载的页数
返回值
cellWillAppear
设置cell将要显示回调
设置cell将要显示的回调,业务可以在cell即将显示的时候做一些处理
回调格式:
```
function(table cell,number position)
---cell:将要展示的cell
---position:将要展示的索引
end
```
参数
返回值
cellDidDisappear
设置cell已经消失的回调
设置cell已经消失的回调,业务可以在cell已经消失后做一些处理
回调格式:
```
function(table cell, number position)
---cell:将要消失的cell
---position:将要消失的索引
end
```
参数
返回值
setPageClickListener
设置点击了某一页的回调
设置点击了某一页的回调,回调选中也的page索引值
回调格式:
```
function(number position)
---page:点击的页码
end
参数
- callback : function(position)
返回值
setScrollEnable
设置是否开可滚动
设置是否开启滚动,默认为true
参数
- enable : boolean 是否开启滚动
返回值
setTabScrollingListener
设置滚动百分比回调
回调格式:
```
function(number progress, number fromIndex, number toIndex)
---progress:滚动的百分比
---fromIndex:滚动前page的索引
---toIndex:滚动后page的索引
end
```