Skip to content

方法

挂载在swiper实例中的方法。

slideTo

将swiper切换到指定下标

参数名称类型必填描述
indexnumber目标item的下标
speednumber切换速度(单位ms)
runCallbacksboolean是否触发transition回调

slideToLoop

loop无限循环的情况下将swiper切换到指定下标

参数名称类型必填描述
indexnumber目标item的下标
speednumber切换速度(单位ms)
runCallbacksboolean是否触发transition回调

slideNext

将swiper切换至下一个item

参数名称类型必填描述
speednumber切换速度(单位ms)
runCallbacksboolean是否触发transition回调

slidePrev

将swiper切换至上一个item

参数名称类型必填描述
speednumber切换速度(单位ms)
runCallbacksboolean是否触发transition回调

enable & disable

启用和禁用swiper

destroy

销毁swiper

参数名称类型必填描述
deleteInstanceboolean是否销毁swiper实例
cleanupStylesboolean是否清除swiper样式

changeDirection

动态切换swiper的滑动方向

参数名称类型必填描述
directionstring切换的方向 horizontal vertical

getTranslate

获取swiper当前实时的translate

vue
<DemoOprate
  type="primary"
  @click="() => swiperInstance['getTranslate'].getTranslate()"
>获取当前的translate</DemoOprate>

setTranslate

设置swiper的translate

参数名称类型必填描述
translatenumber单位px

translateTo

设置transform中的translate位移

参数名称类型必填描述
translatenumber位移的值,单位px
speednumber动画持续时间,单位ms
runCallbacksboolean是否触发transition回调
translateBoundsboolean是否在swiper的位移区间中移动

setProgress

通过进度百分比设置swiper的位移

参数名称类型必填描述
progressnumber进度,范围0-1
speednumber动画持续时间,单位ms

attachEvents && detachEvents

重新绑定事件和移除绑定事件

on & off

设置swiper监听,移除swiper监听

once

添加swiper监听,该监听中的回调只执行一次

vue
<DemoOprate
  type="primary"
  @click="
    () =>
      swiperInstance['once'].once('click', () => {
        console.log('swiper点击了')
      })
  "
>监听swiper点击</DemoOprate>

emit

触发swiper监听

vue
<DemoOprate
  type="primary"
  @click="() => swiperInstance['emit'].emit('click')"
>触发swiper监听</DemoOprate>

maxTranslate & minTranslate

获取当前最大和最小位移值

vue
<DemoOprate
  type="primary"
  @click="() => swiperInstance['maxTranslate'].maxTranslate()"
>获取最大位移值</DemoOprate>

setGrabCursor & unsetGrabCursor

开启鼠标抓手,关闭鼠标抓手

slideToClosest

设置swiper到最近的边界

参数名称类型必填描述
speednumber切换速度(单位ms)
runCallbacksboolean是否触发transition回调
vue
<DemoOprate
  type="primary"
  @click="() => swiperInstance['slideToClosest'].slideToClosest(3000)"
>slideToClosest</DemoOprate>

updateAutoHeight

当开启高度自适应时,设置高度自适应动画的持续时间

参数名称类型必填描述
speednumber动画持续时间,单位ms
vue
<DemoOprate
  type="primary"
  @click="() => swiperInstance['updateAutoHeight'].updateAutoHeight(3000)"
>updateAutoHeight</DemoOprate>

updateSize

更新swiper的尺寸

swiper的高度:

updateSlides

更新item的数量和偏移。

vue
<DemoOprate
  type="primary"
  @click="() => swiperInstance['updateSlides'].updateSlides()"
>updateSlides</DemoOprate>

updateProgress

更新swiper的progress。

vue
<DemoOprate
  type="primary"
  @click="() => swiperInstance['updateProgress'].updateProgress()"
>updateProgress</DemoOprate>

updateSlidesClasses

更新item的类名。

vue
<DemoOprate
  type="primary"
  @click="() => swiperInstance['updateSlidesClasses'].updateSlidesClasses()"
>updateSlidesClasses</DemoOprate>

update

更新swiper

vue
<DemoOprate
  type="primary"
  @click="() => swiperInstance['update'].update()"
>update</DemoOprate>

Released under the MIT License.