Backtop 回到顶部
WebH5
回到顶部。页面滚动超过 visibilityHeight 后,右下角淡入圆形悬浮按钮,点击平滑滚动回顶部;默认监听 window 滚动,也可用 target 指定滚动容器。
何时使用
长列表、长文档页面,方便用户快速回到顶部。
何时不使用
短页面无需使用;有底部固定操作栏时注意 bottom 避让。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
target | string | "" | 滚动容器选择器(如 '#main-scroll'),为空时监听 window 滚动 |
visibilityHeight | number | 200 | 滚动超过该高度(px)后显示按钮 |
right | number | 40 | 距视口右边缘距离(px) |
bottom | number | 40 | 距视口下边缘距离(px) |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
click | MouseEvent | 点击按钮时触发(随后自动平滑滚动回顶) |
示例
基础(监听 window)
示例加载中…
自定义位置与阈值
示例加载中…
指定滚动容器
示例加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Backtop 文档(含手机预览)。