- 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 | 自定义指示器 |
