Skip to content
CONTENTS

Scrollbar 滚动条

用于替换浏览器原生滚动条。

基础用法

通过 height 属性设置滚动条高度,若不设置则根据父容器高度自适应。

横向滚动

显示横向滚动条不可设置 heightmax-height,当元素宽度大于滚动条宽度时,会显示横向滚动条。

最大高度

当元素高度超过最大高度,才会显示滚动条。

手动滚动

通过使用 setScrollTopsetScrollLeft 方法,可以手动控制滚动条滚动。

API

属性

属性名描述类型默认
height滚动条高度string / number
max-height滚动条最大高度string / number
native是否使用原生滚动条样式booleanfalse
wrap-style包裹容器的自定义样式Object
wrap-class包裹容器的自定义类名string
view-style视图的自定义样式Object
view-class视图的自定义类名string
noresize不响应容器尺寸变化,如果容器尺寸不会发生变化,最好设置它可以优化性能booleanfalse
tag视图的元素标签stringdiv
always滚动条总是显示booleanfalse
min-size滚动条最小尺寸number20

事件

参数说明类型
scroll当触发滚动事件时,返回滚动的距离function

插槽

插槽名说明
default自定义默认内容

对外暴露的方法

参数说明类型
setScrollTop设置滚动条到顶部的距离function
setScrollLeft设置滚动条到左边的距离function
wrapRef滚动条包裹的 ref 对象object

Released under the MIT License.