- Swipe 轮播
- 代码演示
- 基础用法
- 图片懒加载
- 监听 change 事件
- 纵向滚动
- 控制滑块大小
- 自定义指示器
- API
- Swipe Props
- Swipe Events
- SwipeItem Events
- Swipe 方法
- Swipe Slots
Swipe 轮播
引入
import { Swipe, SwipeItem } from 'vant';
Vue.use(Swipe).use(SwipeItem);
代码演示
基础用法
通过autoplay
属性设置自动轮播间隔
<van-swipe :autoplay="3000" indicator-color="white">
<van-swipe-item>1</van-swipe-item>
<van-swipe-item>2</van-swipe-item>
<van-swipe-item>3</van-swipe-item>
<van-swipe-item>4</van-swipe-item>
</van-swipe>
图片懒加载
配合 Lazyload 组件实现图片懒加载
<van-swipe :autoplay="3000">
<van-swipe-item v-for="(image, index) in images" :key="index">
<img v-lazy="image" />
</van-swipe-item>
</van-swipe>
export default {
data() {
return {
images: [
'https://img.yzcdn.cn/1.jpg',
'https://img.yzcdn.cn/2.jpg'
]
}
}
}
监听 change 事件
<van-swipe @change="onChange">
<van-swipe-item>1</van-swipe-item>
<van-swipe-item>2</van-swipe-item>
<van-swipe-item>3</van-swipe-item>
<van-swipe-item>4</van-swipe-item>
</van-swipe>
export default {
methods: {
onChange(index) {
Toast('当前 Swipe 索引:' + index);
}
}
}
纵向滚动
<van-swipe :autoplay="3000" vertical>
<van-swipe-item>1</van-swipe-item>
<van-swipe-item>2</van-swipe-item>
<van-swipe-item>3</van-swipe-item>
<van-swipe-item>4</van-swipe-item>
</van-swipe>
控制滑块大小
<van-swipe :autoplay="3000" :width="300">
<van-swipe-item>1</van-swipe-item>
<van-swipe-item>2</van-swipe-item>
<van-swipe-item>3</van-swipe-item>
<van-swipe-item>4</van-swipe-item>
</van-swipe>
自定义指示器
<van-swipe @change="onChange">
<van-swipe-item>1</van-swipe-item>
<van-swipe-item>2</van-swipe-item>
<van-swipe-item>3</van-swipe-item>
<van-swipe-item>4</van-swipe-item>
<div class="custom-indicator" slot="indicator">
{{ current + 1 }}/4
</div>
</van-swipe>
export default {
data() {
return {
current: 0
}
},
methods: {
onChange(index) {
this.current = index;
}
}
}
API
Swipe Props
参数 | 说明 | 类型 | 默认值 | 版本 |
---|
autoplay | 自动轮播间隔,单位为 ms | Number | - | - |
duration | 动画时长,单位为 ms | Number | 500 | - |
initial-swipe | 初始位置索引值 | Number | 0 | - |
loop | 是否开启循环播放 | Boolean | true | - |
show-indicators | 是否显示指示器 | Boolean | true | - |
indicator-color | 指示器颜色 | String | #1989fa | 1.4.5 |
vertical | 是否为纵向滚动 | Boolean | false | 1.1.1 |
touchable | 是否可以通过手势滑动 | Boolean | true | 1.1.1 |
width | 滑块宽度 | Number | 0 | 1.2.1 |
height | 滑块高度 | Number | 0 | 1.2.1 |
Swipe Events
事件名 | 说明 | 回调参数 |
---|
change | 每一页轮播结束后触发 | index, 当前页的索引 |
SwipeItem Events
Swipe 方法
通过 ref 可以获取到 swipe 实例并调用实例方法
方法名 | 参数 | 返回值 | 介绍 |
---|
swipeTo | index: 目标位置的索引 | void | 滚动到目标位置 |
Swipe Slots
名称 | 说明 |
---|
default | 轮播内容 |
indicator | 自定义指示器 |