Carousel 走马灯

轮播组件,支持自动播放、方向切换、多种指示点样式、箭头触发方式及循环控制。

基础用法
默认水平方向自动播放,左右箭头切换,底部圆点指示器跳转。
指示点样式
通过 dot-type 设置指示点样式,支持 dot(圆点)、line(线段)、number(数字)三种。

dot(默认)

line

number

指示点位置
通过 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

参数类型默认值说明
autoplaybooleantrue是否自动播放
intervalnumber3000自动播放间隔(ms)
durationnumber400切换动画时长(ms)
loopbooleantrue是否循环播放
direction'horizontal' | 'vertical''horizontal'轮播方向
dotType'dot' | 'line' | 'number''dot'指示点样式
dotPosition'bottom' | 'top' | 'left' | 'right''bottom'指示点位置
showDotsbooleantrue是否显示指示点
showArrowbooleantrue是否显示箭头
arrowTrigger'always' | 'hover''always'箭头显示触发方式
pauseOnHoverbooleantrue鼠标悬停时暂停自动播放
heightnumber | string容器高度(垂直方向时有用)

Events

事件名类型说明
change(current: number, prev: number) => void轮播切换时触发

Slots

插槽名说明
default轮播子项内容

Methods

方法名类型说明
prev() => void切换到上一张
next() => void切换到下一张
goTo(index: number) => void切换到指定索引