跳到主要内容

Backtop 回到顶部 ​

WebH5

回到顶部。页面滚动超过 visibilityHeight 后,右下角淡入圆形悬浮按钮,点击平滑滚动回顶部;默认监听 window 滚动,也可用 target 指定滚动容器。

何时使用 ​

长列表、长文档页面,方便用户快速回到顶部。

何时不使用 ​

短页面无需使用;有底部固定操作栏时注意 bottom 避让。

Props ​

名称类型默认值说明
targetstring""滚动容器选择器(如 '#main-scroll'),为空时监听 window 滚动
visibilityHeightnumber200滚动超过该高度(px)后显示按钮
rightnumber40距视口右边缘距离(px)
bottomnumber40距视口下边缘距离(px)

Events ​

名称载荷说明
clickMouseEvent点击按钮时触发(随后自动平滑滚动回顶)

示例 ​

基础(监听 window) ​

示例加载中…

自定义位置与阈值 ​

示例加载中…

指定滚动容器 ​

示例加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Backtop 文档(含手机预览)。