基础用法

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

最大高度

横向滚动

当元素宽度大于滚动条宽度时,会显示横向滚动条。

滚动条总是显示

当元素宽度大于滚动条宽度时,会显示横向滚动条。

手动滚动

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

使用原生滚动条样式

Attributes

属性名类型默认值描述
heightstring | number100%容器高度
max-heightstring | number容器最大高度
nativebooleanfalse是否使用原生滚动条样式
box-stylestring包裹容器的自定义样式
box-classstring包裹容器的自定义类名
content-stylestring内容区域的自定义样式
content-classstring内容区域的自定义类名
noresizeBooleanfalse不响应容器尺寸变化,如果容器尺寸不会发生变化,最好设置它可以优化性能
alwaysBooleanfalse滚动条总是显示
min-sizenumber20滑块最小尺寸
barBackgroundColorstringtransparent滚动条区域背景
barYSizestring6px竖向滚动条大小
barYHoverSizestring8px竖向滚动条悬浮大小
barXSizestring12px横向滚动条大小
barXHoverSizestring16px横向滚动条悬浮大小
thumbColorstringrgba(196, 201, 207, 0.8)滑块颜色
thumbHoverColorstringrgba(196, 201, 207, 1)滑块悬浮颜色
containerFunction自定义包裹容器
contentFunction自定义内容区域

Events

事件名描述返回值
scroll当触发滚动事件时,返回滚动的距离({ scrollLeft: number, scrollTop: number }) => void
scrollToBoundary当滚动到边界值时事件(boundary: 'left' | 'right' | 'top' | 'bottom') => void

Slots

插槽名描述
default自定义默认内容

Exposes

名称说明类型
handleScroll触发滚动事件() => void
scrollTo滚动到一组特定坐标(arg1: ScrollToOptions | number, arg2?:number) => void
setScrollTop设置滚动条到顶部的距离(scrollTop: number | 'end') => void
setScrollLeft设置滚动条到左边的距离(scrollLeft: number | 'end') => void
update手动更新滚动条状态() => void
boxRef滚动条包裹的 ref 对象Ref<HTMLDivElement>

最近更新于: