Skip to content

BackTop 回到顶部

返回页面顶部的操作按钮。

基础用法

自定义内容

设置滚动目标

瞬间滚动

API

Props

参数说明类型默认值
v-model:active绑定当前组件是否显示的标识符boolearnfalse
target触发滚动的目标对象,支持传入选择器或 DOM 元素,默认最近的父级滚动容器string | HTMLElement-
right距离页面右侧的距离,默认单位为 pxnumber | string30
bottom距离页面底部的距离,默认单位为 pxnumber | string40
offset滚动高度达到此参数值时才显示组件number200
teleport指定挂载的节点,等同于 Teleport 组件的 to 属性string | Elementbody
immediate是否瞬间滚动到顶部booleanfalse
z-index设置组件的 z-index 层级number | string100

Events

事件名说明回调参数
click点击组件时触发event: MouseEvent

Slots

名称说明
default自定义按钮显示内容

类型定义

组件导出以下类型定义:

ts
import type { BackTopProps, BackTopThemeVars } from 'ryxon'

主题定制

样式变量

组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件

名称默认值描述
--r-back-top-size40px-
--r-back-top-icon-size20px-
--r-back-top-right30px-
--r-back-top-bottom40px-
--r-back-top-z-index100-
--r-back-top-text-color#fff-
--r-back-top-backgroundvar(--r-primary-color)-

Released under the MIT License.