Skip to content

Scroll 滚动条

下方展示了滚动条组件的基本使用

水平滚动

触发方式

你可以设定不同的触发方式,trigger="none" 会让滚动条一直显示,trigger="hover" 会让滚动条在鼠标悬浮的时候显示。

自定义样式

滚动条位置

通过 y-placement 和 x-placement 去控制滚动条的位置。

API

Props

参数说明类型默认值
yPlacement垂直滚动条位置'left' | 'right''right'
xPlacement水平滚动条位置'top' | 'bottom''bottom'
scrollable是否可滚动booleantrue
useUnifiedContainer是否使用统一容器boolean-
railSize滚动条大小number5
minRailSize滚动条最小大小number20
showXScroll是否显示水平滚动条booleantrue
showYScroll是否显示垂直滚动条booleantrue
railColor滚动条颜色string'rgba(0, 0, 0, 0.25)'
railHoverColor滚动条悬停颜色string'rgba(0, 0, 0, 0.4)'
trigger滚动条显示时机'hover' | 'none''hover'
customClass自定义样式类名string''
customRailStyle自定义滚动条样式Record<string, any>{}
customBarStyle自定义滚动条滑块样式Record<string, any>{}
customContainerStyle自定义容器样式Record<string, any>{}
customContentStyle自定义内容区域样式Record<string, any>{}

事件

事件名说明回调参数
scroll滚动时触发{ scrollLeft: number, scrollTop: number }