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
轮播组件页容器。