Carousel 走马灯
WebH5
走马灯。轮播展示一组内容,支持自动播放、循环、触摸滑动跟手与指示点导航。自动播放时提供暂停/继续开关(键盘第一个停靠点),系统开启「减少动态效果」时默认暂停。
何时使用
首页 Banner、图片/卡片轮播、新手引导分页。
何时不使用
内容超过 5 屏或需要标题联动的分页场景,用 Tabs。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
autoplay | number | 0 | 自动播放间隔(毫秒),0 表示不自动播放 |
loop | boolean | true | 循环播放;关闭后播放到末屏停止 |
showArrows | boolean | false | 显示左右切换箭头(桌面端悬停容器时出现) |
showDots | boolean | true | 显示底部指示点,激活项拉长为胶囊 |
height | string | "200px" | 容器高度 |
initialIndex | number | 0 | 初始显示的屏索引 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
change | number | 切换屏时触发,参数为当前索引 |
Slots
| 名称 | 说明 |
|---|---|
default | 若干屏内容,每个顶层子节点作为一屏 |
Methods
| 名称 | 签名 | 说明 |
|---|---|---|
goTo | goTo(index: number): void | 跳转到指定屏(循环模式自动取模,loop 关闭时 clamp 到边界) |
next | next(): void | 切换到下一屏 |
prev | prev(): void | 切换到上一屏 |
currentIndex | Ref<number> | 当前屏索引的响应式引用(配合 template ref 读取) |
示例
促销 Banner
示例加载中…
自动播放 + 箭头
示例加载中…
切换回显当前页
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Carousel 文档(含手机预览)。