## Swipe 轮播
### 使用指南
``` javascript
import { Swipe, SwipeItem } from 'vant';
Vue.use(Swipe).use(SwipeItem);
```
### 代码演示
#### 基础用法
通过`autoplay`属性设置自动轮播间隔
```html
1
2
3
4
```
#### 图片懒加载
配合 [Lazyload](#/zh-CN/lazyload) 组件实现图片懒加载
```html
![]()
```
```javascript
export default {
data() {
return {
images: [
'https://img.yzcdn.cn/1.jpg',
'https://img.yzcdn.cn/2.jpg'
]
}
}
}
```
#### 监听 change 事件
```html
1
2
3
4
```
```js
export default {
methods: {
onChange(index) {
Toast('当前 Swipe 索引：' + index);
}
}
}
```
#### 纵向滚动
```html
1
2
3
4
```
#### 控制滑块大小
```html
1
2
3
4
```
#### 自定义指示器
```html
1
2
3
4
{{ this.current + 1 }}/4
```
```js
export default {
methods: {
data() {
return {
current: 0
}
},
onChange(index) {
this.current = index;
}
}
}
```
### API
| 参数 | 说明 | 类型 | 默认值 |
|-----------|-----------|-----------|-------------|
| autoplay | 自动轮播间隔，单位为 ms | `Number` | - |
| duration | 动画时长，单位为 ms | `Number` | `500` |
| loop | 是否开启循环播放 | `Boolean` | `true` |
| vertical | 是否为纵向滚动 | `Boolean` | `false` |
| touchable | 是否可以通过手势滑动 | `Boolean` | `true` |
| show-indicators | 是否显示指示器 | `Boolean` | `true` |
| initial-swipe | 初始位置，从 0 开始算 | `Number` | `0` |
| width | 设置滑块宽度 | `Number` | `0` |
| height | 设置滑块高度 | `Number` | `0` |
### 事件
| 事件名 | 说明 | 参数 |
|-----------|-----------|-----------|
| change | 每一页轮播结束后触发 | index, 当前页的索引 |
### 方法
通过 ref 可以获取到 swipe 实例并调用实例方法
| 方法名 | 参数 | 返回值 | 介绍 |
|-----------|-----------|-----------|-------------|
| swipeTo | index: 目标位置的索引 | void | 滚动到目标位置 |
### 插槽
| 名称 | 说明 |
|-----------|-----------|
| - | 轮播内容 |
| indicator | 自定义指示器 |
### 更新日志
| 版本 | 类型 | 内容 |
|-----------|-----------|-----------|
| 1.3.0 | bugfix | 修复特定手势下可能出现位置错误的问题
| 1.2.1 | feature | 新增 width、height 属性
| 1.1.15 | feature | 新增 open 方法
| 1.1.13 | bugfix | 修复多指触控时导致空白的问题
| 1.1.12 | bugfix | 修复浏览器滚动时会触发轮播左右滚动的问题
| 1.1.12 | feature | 屏幕大小变化时自动调整宽度
| 1.1.7 | feature | 新增 swipeTo 方法
| 1.1.1 | feature | 新增 touchable 属性
| 1.1.1 | feature | 新增 vertical 属性，支持垂直布局