Carousel 走马灯
轮播组件,支持自动播放、方向切换、多种指示点样式、箭头触发方式及循环控制。
基础用法
默认水平方向自动播放,左右箭头切换,底部圆点指示器跳转。
指示点样式
通过 dot-type 设置指示点样式,支持 dot(圆点)、line(线段)、number(数字)三种。
dot(默认)
line
number
1 / 0
指示点位置
通过 dot-position 设置指示点位置,水平方向支持 top / bottom,垂直方向支持 left / right。
bottom(默认)
top
垂直方向
设置 direction 为 vertical 开启垂直轮播,需指定容器高度。
箭头触发方式
通过 arrow-trigger 设置箭头显示方式:always(始终显示)和 hover(悬停显示)。
always(默认)
hover(悬停显示)
关闭自动播放
设置 autoplay 为 false 关闭自动播放。
自定义间隔与速度
通过 interval 设置自动播放间隔毫秒数,duration 设置切换动画时长毫秒数。
禁止循环
设置 loop 为 false 后,到达首尾不再循环切换。
隐藏箭头与指示点
通过 show-arrow 和 show-dots 控制箭头和指示点的显示。
无箭头
无指示点
图片轮播
搭配 Image 组件实现图片轮播,开启预览功能。



Props
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
autoplay | boolean | true | 是否自动播放 |
interval | number | 3000 | 自动播放间隔(ms) |
duration | number | 400 | 切换动画时长(ms) |
loop | boolean | true | 是否循环播放 |
direction | 'horizontal' | 'vertical' | 'horizontal' | 轮播方向 |
dotType | 'dot' | 'line' | 'number' | 'dot' | 指示点样式 |
dotPosition | 'bottom' | 'top' | 'left' | 'right' | 'bottom' | 指示点位置 |
showDots | boolean | true | 是否显示指示点 |
showArrow | boolean | true | 是否显示箭头 |
arrowTrigger | 'always' | 'hover' | 'always' | 箭头显示触发方式 |
pauseOnHover | boolean | true | 鼠标悬停时暂停自动播放 |
height | number | string | — | 容器高度(垂直方向时有用) |
Events
| 事件名 | 类型 | 说明 |
|---|---|---|
change | (current: number, prev: number) => void | 轮播切换时触发 |
Slots
| 插槽名 | 说明 |
|---|---|
default | 轮播子项内容 |
Methods
| 方法名 | 类型 | 说明 |
|---|---|---|
prev | () => void | 切换到上一张 |
next | () => void | 切换到下一张 |
goTo | (index: number) => void | 切换到指定索引 |