BackTop 设计文档

回到顶部悬浮按钮:滚动超过 visibilityHeight(默认 400px) 时显现、点击平滑缓动(easeInOutCubic, duration 默认 450ms)滚回顶部;默认监听 window,可经 target 指定自定义滚动容器;默认渲染 IconButton(theme="light") + IconChevronUp,可用 children 完全自定义。严格对齐 Semi。

← API 文档

使用建议

回到顶部悬浮按钮:滚动超过 visibilityHeight(默认 400px) 时显现、点击平滑缓动(easeInOutCubic, duration 默认 450ms)滚回顶部;默认监听 window,可经 target 指定自定义滚动容器;默认渲染 IconButton(theme="light") + IconChevronUp,可用 children 完全自定义。严格对齐 Semi。

Accessibility

  • 对齐 Semi:外层 div.cd-back-top 为可点击容器,真实按钮语义/键盘可聚焦/可访问名(locale BackTop.ariaLabel)由内部 IconButton(theme="light") 承担;不可见时不在 DOM。

设计变量

变量默认值用法
--cd-backtop-z var(--cd-z-affix)按钮 z-index(对齐 Semi $z-backtop: 10)