返回顶部 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
组件内部
<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 | 页面滚动高度达到该值时才显示BackTop | Number | — | 400 |
target | 目标容器标识,可设置目标的class、id标识来制定滚动监听的内容 | String | — | — |
bottom | 组件距离底部的距离 | Number | — | 50 |
right | 组件距离右部的距离 | Number | — | 50 |
duration | 滚动动画持续时间,单位 毫秒 | Number | — | 1000 |
Events
事件名 | 说明 | 返回值 |
---|---|---|
click | 点击按钮时触发 | 无 |