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) |