Carousel 轮播

以轮播的方式显示一组元素

获取组件

import { Carousel } from 'rsuite';

示例

默认

基本轮播图,包含 5 张图片,可以通过底部的指示点进行切换。

受控的幻灯片

通过 activeIndexonSelect 属性可以控制当前显示的幻灯片,实现完全受控的轮播图。

外观

可以自定义轮播图指示器的位置(上、下、左、右)和形状(圆点或条状)。

自动轮播

设置 autoplay 属性可以启用自动轮播功能,无需用户交互即可自动切换幻灯片。

Props

属性名称 类型(默认值) 描述
activeIndex number 控制当前可见幻灯片
as ElementType ('div') 自定义元素类型
autoplay boolean 自动轮播
children ReactNode 轮播的元素
classPrefix string ('carousel') 组件 CSS 类的前缀
defaultActiveIndex number (0) 默认的初始幻灯片
onSelect (index: number, event?: ChangeEvent) => void 活动项更改时触发的回调
onSlideEnd (index: number, event?: TransitionEvent) => void 幻灯片过渡结束时触发的回调
onSlideStart (index: number, event?: ChangeEvent) => void 幻灯片过渡开始时触发的回调
placement enum:'top','bottom','left','right' ('bottom') 按钮的位置
shape enum:'dot','bar' ('dot') 按钮的形状