Skip to content
On this page

返回顶部 Backtop

当页面内容比较长滚动后需要快捷返回顶部时使用,一般放置在页面右下角位置。如果指定 target 使用则是针对某个容器的滚动

基础用法

直接用组件默认插槽插入即可

1:这是用来撑开内容的行...
2:这是用来撑开内容的行...
3:这是用来撑开内容的行...
4:这是用来撑开内容的行...
5:这是用来撑开内容的行...
6:这是用来撑开内容的行...
7:这是用来撑开内容的行...
8:这是用来撑开内容的行...
9:这是用来撑开内容的行...
10:这是用来撑开内容的行...
11:这是用来撑开内容的行...
12:这是用来撑开内容的行...
13:这是用来撑开内容的行...
14:这是用来撑开内容的行...
15:这是用来撑开内容的行...
16:这是用来撑开内容的行...
17:这是用来撑开内容的行...
18:这是用来撑开内容的行...
19:这是用来撑开内容的行...
20:这是用来撑开内容的行...
21:这是用来撑开内容的行...
22:这是用来撑开内容的行...
23:这是用来撑开内容的行...
24:这是用来撑开内容的行...
25:这是用来撑开内容的行...
26:这是用来撑开内容的行...
27:这是用来撑开内容的行...
28:这是用来撑开内容的行...
29:这是用来撑开内容的行...
30:这是用来撑开内容的行...
31:这是用来撑开内容的行...
32:这是用来撑开内容的行...
33:这是用来撑开内容的行...
34:这是用来撑开内容的行...
35:这是用来撑开内容的行...
36:这是用来撑开内容的行...
37:这是用来撑开内容的行...
38:这是用来撑开内容的行...
39:这是用来撑开内容的行...
40:这是用来撑开内容的行...
41:这是用来撑开内容的行...
42:这是用来撑开内容的行...
43:这是用来撑开内容的行...
44:这是用来撑开内容的行...
45:这是用来撑开内容的行...
46:这是用来撑开内容的行...
47:这是用来撑开内容的行...
48:这是用来撑开内容的行...
49:这是用来撑开内容的行...
50:这是用来撑开内容的行...
51:这是用来撑开内容的行...
52:这是用来撑开内容的行...
53:这是用来撑开内容的行...
54:这是用来撑开内容的行...
55:这是用来撑开内容的行...
56:这是用来撑开内容的行...
57:这是用来撑开内容的行...
58:这是用来撑开内容的行...
59:这是用来撑开内容的行...
60:这是用来撑开内容的行...
61:这是用来撑开内容的行...
62:这是用来撑开内容的行...
63:这是用来撑开内容的行...
64:这是用来撑开内容的行...
65:这是用来撑开内容的行...
66:这是用来撑开内容的行...
67:这是用来撑开内容的行...
68:这是用来撑开内容的行...
69:这是用来撑开内容的行...
70:这是用来撑开内容的行...
71:这是用来撑开内容的行...
72:这是用来撑开内容的行...
73:这是用来撑开内容的行...
74:这是用来撑开内容的行...
75:这是用来撑开内容的行...
76:这是用来撑开内容的行...
77:这是用来撑开内容的行...
78:这是用来撑开内容的行...
79:这是用来撑开内容的行...
80:这是用来撑开内容的行...
<template>
  <div style="position: relative; border: 1px solid #eee">
    <div class="scroll-box" style="padding: 20px; height: 500px; overflow: auto">
      <div v-for="item in 80" :key="item" ref="item">{{ item }}:这是用来撑开内容的行...</div>
    </div>
    <b-back-top target=".scroll-box" :visible-height="200">
      <b-button type="success">返回顶端</b-button>
    </b-back-top>
  </div>
</template>
<template>
  <div style="position: relative; border: 1px solid #eee">
    <div class="scroll-box" style="padding: 20px; height: 500px; overflow: auto">
      <div v-for="item in 80" :key="item" ref="item">{{ item }}:这是用来撑开内容的行...</div>
    </div>
    <b-back-top target=".scroll-box" :visible-height="200">
      <b-button type="success">返回顶端</b-button>
    </b-back-top>
  </div>
</template>

scrollbar用法

如果结合 scrollbar 使用则不需要配置其他项

注意:如嵌套在自定义滚动组件中使用则需要将 BackTop 组件放置于 Scrollbar 组件内部

1:这是用来撑开内容的行...
2:这是用来撑开内容的行...
3:这是用来撑开内容的行...
4:这是用来撑开内容的行...
5:这是用来撑开内容的行...
6:这是用来撑开内容的行...
7:这是用来撑开内容的行...
8:这是用来撑开内容的行...
9:这是用来撑开内容的行...
10:这是用来撑开内容的行...
11:这是用来撑开内容的行...
12:这是用来撑开内容的行...
13:这是用来撑开内容的行...
14:这是用来撑开内容的行...
15:这是用来撑开内容的行...
16:这是用来撑开内容的行...
17:这是用来撑开内容的行...
18:这是用来撑开内容的行...
19:这是用来撑开内容的行...
20:这是用来撑开内容的行...
21:这是用来撑开内容的行...
22:这是用来撑开内容的行...
23:这是用来撑开内容的行...
24:这是用来撑开内容的行...
25:这是用来撑开内容的行...
26:这是用来撑开内容的行...
27:这是用来撑开内容的行...
28:这是用来撑开内容的行...
29:这是用来撑开内容的行...
30:这是用来撑开内容的行...
31:这是用来撑开内容的行...
32:这是用来撑开内容的行...
33:这是用来撑开内容的行...
34:这是用来撑开内容的行...
35:这是用来撑开内容的行...
36:这是用来撑开内容的行...
37:这是用来撑开内容的行...
38:这是用来撑开内容的行...
39:这是用来撑开内容的行...
40:这是用来撑开内容的行...
41:这是用来撑开内容的行...
42:这是用来撑开内容的行...
43:这是用来撑开内容的行...
44:这是用来撑开内容的行...
45:这是用来撑开内容的行...
46:这是用来撑开内容的行...
47:这是用来撑开内容的行...
48:这是用来撑开内容的行...
49:这是用来撑开内容的行...
50:这是用来撑开内容的行...
51:这是用来撑开内容的行...
52:这是用来撑开内容的行...
53:这是用来撑开内容的行...
54:这是用来撑开内容的行...
55:这是用来撑开内容的行...
56:这是用来撑开内容的行...
57:这是用来撑开内容的行...
58:这是用来撑开内容的行...
59:这是用来撑开内容的行...
60:这是用来撑开内容的行...
61:这是用来撑开内容的行...
62:这是用来撑开内容的行...
63:这是用来撑开内容的行...
64:这是用来撑开内容的行...
65:这是用来撑开内容的行...
66:这是用来撑开内容的行...
67:这是用来撑开内容的行...
68:这是用来撑开内容的行...
69:这是用来撑开内容的行...
70:这是用来撑开内容的行...
71:这是用来撑开内容的行...
72:这是用来撑开内容的行...
73:这是用来撑开内容的行...
74:这是用来撑开内容的行...
75:这是用来撑开内容的行...
76:这是用来撑开内容的行...
77:这是用来撑开内容的行...
78:这是用来撑开内容的行...
79:这是用来撑开内容的行...
80:这是用来撑开内容的行...
<template>
  <div style="height: 500px; overflow: auto; border: 1px solid #eee">
    <b-scrollbar style="height: 100%" wrap-class="scrollbar-box">
      <div style="padding: 20px">
        <div v-for="item in 80" :key="item" ref="item">{{ item }}:这是用来撑开内容的行...</div>
      </div>
      <b-back-top target=".scrollbar-box" :visible-height="200">
        <b-button type="info" size="large" icon="up"></b-button>
      </b-back-top>
    </b-scrollbar>
  </div>
</template>
<template>
  <div style="height: 500px; overflow: auto; border: 1px solid #eee">
    <b-scrollbar style="height: 100%" wrap-class="scrollbar-box">
      <div style="padding: 20px">
        <div v-for="item in 80" :key="item" ref="item">{{ item }}:这是用来撑开内容的行...</div>
      </div>
      <b-back-top target=".scrollbar-box" :visible-height="200">
        <b-button type="info" size="large" icon="up"></b-button>
      </b-back-top>
    </b-scrollbar>
  </div>
</template>

Props

参数说明类型可选值默认值
visible-height页面滚动高度达到该值时才显示BackTopNumber400
target目标容器标识,可设置目标的class、id标识来制定滚动监听的内容String
bottom组件距离底部的距离Number50
right组件距离右部的距离Number50
duration滚动动画持续时间,单位 毫秒Number1000

Events

事件名说明返回值
click点击按钮时触发