菜单 · 组件

最后更新:2026年8月12日

组件

轮播内容,带控制器和指示点。

Carousel

横向或纵向轮播,附带控制器和指示点。

主要 Props

属性默认值说明
slides必填每页一个根 Element
index / default_index非受控 / 0当前页与初始页
height240.0Swiper 视口高度
looping / autoplayfalse循环和自动播放
interval_ms / duration_ms3000 / 300自动播放间隔和切换时长
transition_curve默认曲线CarouselTransitionCurve
item_spacing0相邻页面间距
swipe_enabledtrue是否响应触摸滑动
show_controls / show_indicatorstrue导航按钮和指示器
controls_placementBelowBelowOverlayOverlayCenter
style默认主题CarouselStyle 视口、导航、指示器配置

各 slide 应保持一致主要尺寸;图片提前使用 AspectRatio,避免翻页时布局抖动。自动播放内容必须允许用户手动控制。