项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。
仅桌面端保证样式

Carousel 走马灯 ​

轮播容器:自动播放、指示器(click / hover 触发)、悬停箭头、垂直方向与手动控制。子项必须使用 eb-carousel-item。

基础用法 ​

指示器位置与切换箭头 ​

indicator-position="outside" 指示器移到容器外;arrow="always" 常显切换箭头;trigger="hover" 悬停即切换。

手动控制(程序化切换) ​

通过 ref 暴露的 setActiveItem / prev / next 程序化切换,常与外部按钮联动:

垂直方向 ​

名称类型默认值说明
initial-indexNumber0初始页
heightString—高度(必填,如 160px)
triggerStringclick指示器触发:click / hover
autoplayBooleantrue自动播放
intervalNumber3000播放间隔(ms)
indicator-positionString—outside 容器外 / none 隐藏
arrowStringhover箭头显示:always / hover / never
loopBooleantrue循环播放
directionStringhorizontalhorizontal / vertical
pause-on-hoverBooleantrue悬停暂停

事件:change(index, prevIndex);暴露 setActiveItem(index \| name) / prev() / next();子项使用 eb-carousel-item(可传 name)。