Carousel 轮播
用于在同一可视区域循环展示多屏内容,支持手动切换与自动播放。
基础用法
基础轮播
第一屏
第二屏
第三屏
点击底部圆点可切换屏幕,默认不自动播放。
指定起始索引
受控索引
第一屏
第二屏
第三屏
通过 index 指定当前屏(从 0 开始)。
自动播放
自动播放
自动 1
自动 2
自动 3
设置 autoplay 开启自动播放,interval 控制间隔(毫秒)。
箭头形态
左右箭头支持三种显示形态,通过 arrows 属性控制:always(始终显示)/ hover(悬停显示,默认)/ never(不显示)。箭头点击切换上一屏 / 下一屏,首尾循环。
始终显示(always)
第一屏
第二屏
第三屏
悬停显示(hover)
第一屏
第二屏
第三屏
不显示(never)
第一屏
第二屏
第三屏
默认(未指定 arrows)即悬停显示形态:箭头默认隐藏,鼠标悬停或键盘聚焦轮播区域时平滑淡入。不指定 arrows 时等价于 arrows="hover"。
图片轮播
轮播项不局限于色块——放 <img> 或 SVG 即成图片 banner。
图片 banner(SVG)
图片轮播(img + 自动播放)
事件
切换事件
第一屏
第二屏
第三屏
当前屏:1
API
属性
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
arrows | 箭头显示形态:always(始终显示)/ hover(悬停显示)/ never(不显示) | string | hover |
autoplay | 是否自动播放 | boolean | — |
index | 当前屏索引(从 0 起) | string | 0 |
interval | 自动播放间隔(ms) | string | 3000 |
事件
| 事件 | 说明 |
|---|---|
oas-change | 当前屏切换,detail: { index } |
插槽
| 名称 | 说明 |
|---|---|
| 默认 | — |
部件(::part())
| 部件 | 说明 |
|---|---|
viewport / track | 视口与滑动轨道 |
dots / dot | 底部指示器容器与单个圆点 |
arrow-prev / arrow-next | 左右切换箭头按钮,绝对定位于轮播两侧垂直居中,可单独定制样式 |