Skip to content

swiper

[范例:demo-swiper.vue]

轮播组件,里面只能包含 <swiper-slide> 组件。

**注意事项:**如果在 ul 里嵌套 swiper,因为 ul 自带复用能力,swiper 滚出屏幕后不可在对其进行任何操作(例如通过代码更改 current 值),否则很可能导致终端出错。

属性

参数描述类型
current实时改变当前所处页码number
initialPage指定一个数字,用于决定初始化后默认显示的页面index,默认不指定的时候是0number
needAnimation切换页面时是否需要动画。boolean
scrollEnabled指定ViewPager是否可以滑动,默认为trueboolean
focusSearchEnabled指定swiper内部是否处理焦点搜索,默认为falseboolean
listenFocusSearchOnFail指定swiper是否监听寻焦失败的事件boolean
scrollDuration指定swiper滚动动画执行时间,单位msint

事件

事件名称描述类型
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

[范例:demo-swiper.vue]

轮播组件页容器。