BackTop 返回顶部
参考 uniapp-components 的 BackTop 交互,只保留一个实际可用的返回顶部实例,通过按钮切换当前样式并在长内容区域里验证显隐与回顶。
返回顶部组件,固定在页面右下角,点击后返回页面顶部
演示
9:41
代码示例
引入
推荐使用 easycom 模式,配置后无需手动 import 即可直接使用 <re-back-top />。
API
BackTop Props
| 名称 | 类型 | 默认值 | 描述 | 必传 |
|---|---|---|---|---|
| fixed | boolean | true | 是否固定定位 | N |
| theme | ThemeName | "round" | 主题风格,可选值:round/half-round/round-dark/half-round-dark,default 会映射到 round,primary 会映射到 round-dark | N |
| target | string | "" | 监听滚动条的目标元素选择器,为空时监听页面滚动 | N |
| scrollTop | number | -1 | 当前滚动距离,受控模式下用于控制显隐 | N |
| visibilityHeight | number | 200 | 滚动高度达到此值后显示 | N |
| text | string | "" | 按钮文字内容 | N |
| customStyle | string | "" | 自定义样式 | N |
BackTop Events
| 名称 | 参数 | 描述 |
|---|---|---|
| click | - | 点击返回顶部时触发 |
| to-top | - | 点击触发返回顶部意图 |
BackTop Slots
| 名称 | 描述 |
|---|---|
| - | - |
