Appearance
swiper
轮播组件,里面只能包含 <swiper-slide> 组件。
**注意事项:**如果在 ul 里嵌套 swiper,因为 ul 自带复用能力,swiper 滚出屏幕后不可在对其进行任何操作(例如通过代码更改 current 值),否则很可能导致终端出错。
属性
| 参数 | 描述 | 类型 |
|---|---|---|
| current | 实时改变当前所处页码 | number |
| initialPage | 指定一个数字,用于决定初始化后默认显示的页面index,默认不指定的时候是0 | number |
| needAnimation | 切换页面时是否需要动画。 | boolean |
| scrollEnabled | 指定ViewPager是否可以滑动,默认为true | boolean |
| focusSearchEnabled | 指定swiper内部是否处理焦点搜索,默认为false | boolean |
| listenFocusSearchOnFail | 指定swiper是否监听寻焦失败的事件 | boolean |
| scrollDuration | 指定swiper滚动动画执行时间,单位ms | int |
事件
| 事件名称 | 描述 | 类型 |
|---|---|---|
| dragging | 拖动时触发。 | Function |
| dropped | 页面被切换时触发。 | Function |
| stateChanged* | 手指行为发生改变时触发,包含了 idle、dragging、settling 三种状态,通过 state 参数返回 | Function |
| focusSearchFailed* | 指定swiper内寻焦失败时触发此事件 | Function |
- stateChanged 三种值的意思:
- idle 空闲状态
- dragging 拖拽中
- settling 松手后触发,然后马上回到 idle
- focusSearchFailed返回参数
点击查看源码
javascript
//当前子显示View信息
event.child = {
index:nativeEventParams.child.index,
id:nativeEventParams.child.id,
name:nativeEventParams.child.name,
position:nativeEventParams.child.position,
};
//当前焦点View信息
event.focused = {
id:nativeEventParams.child.id,
name:nativeEventParams.child.name,
};
//寻焦方向
event.direction = nativeEventParams.direction;swiper-slide
轮播组件页容器。