Tui

Scrollbar 滚动条
用于接管滚动位移展示的轻量滚动条组件,支持纵向/横向切换,并可通过 syncTarget 与目标容器实时同步。
纵向滚动条
默认纵向模式(axis="y"),支持拖拽与轨道点击跳转。
日志条目 #01
这是用于演示纵向滚动条的内容,当前序号 1
日志条目 #02
这是用于演示纵向滚动条的内容,当前序号 2
日志条目 #03
这是用于演示纵向滚动条的内容,当前序号 3
日志条目 #04
这是用于演示纵向滚动条的内容,当前序号 4
日志条目 #05
这是用于演示纵向滚动条的内容,当前序号 5
日志条目 #06
这是用于演示纵向滚动条的内容,当前序号 6
日志条目 #07
这是用于演示纵向滚动条的内容,当前序号 7
日志条目 #08
这是用于演示纵向滚动条的内容,当前序号 8
日志条目 #09
这是用于演示纵向滚动条的内容,当前序号 9
日志条目 #10
这是用于演示纵向滚动条的内容,当前序号 10
日志条目 #11
这是用于演示纵向滚动条的内容,当前序号 11
日志条目 #12
这是用于演示纵向滚动条的内容,当前序号 12
日志条目 #13
这是用于演示纵向滚动条的内容,当前序号 13
日志条目 #14
这是用于演示纵向滚动条的内容,当前序号 14
日志条目 #15
这是用于演示纵向滚动条的内容,当前序号 15
日志条目 #16
这是用于演示纵向滚动条的内容,当前序号 16
日志条目 #17
这是用于演示纵向滚动条的内容,当前序号 17
日志条目 #18
这是用于演示纵向滚动条的内容,当前序号 18
示例代码
vue
横向滚动条
通过 axis="x" 切换为横向模式,适合时间轴、卡片流等场景。
横向卡片 1
axis="x" 演示
横向卡片 2
axis="x" 演示
横向卡片 3
axis="x" 演示
横向卡片 4
axis="x" 演示
横向卡片 5
axis="x" 演示
横向卡片 6
axis="x" 演示
横向卡片 7
axis="x" 演示
横向卡片 8
axis="x" 演示
横向卡片 9
axis="x" 演示
横向卡片 10
axis="x" 演示
横向卡片 11
axis="x" 演示
横向卡片 12
axis="x" 演示
示例代码
vue
属性 Props
属性名
说明
类型
可选值
默认值
版本说明
modelValue
当前滚动偏移量(px)
number
-
0
viewportSize
可视区域尺寸(px)
number
-
0
contentSize
内容总尺寸(px)
number
-
0
syncTarget
同步滚动目标容器(传入 HTMLElement)
HTMLElement
-
-
axis
滚动轴向
'x' | 'y'
x / y
y
added 0.6.9
minThumbSize
滚动块最小尺寸
number
-
26
visible
是否显示滚动条
boolean
true / false
true
trackClickable
是否支持点击轨道跳转
boolean
true / false
true
trackBg
轨道颜色
string
-
-
thumbBg
滚动块颜色
string
-
-
thumbHoverBg
滚动块 hover 颜色
string
-
-
width
滚动条厚度(横向为高度,纵向为宽度)
number | string
-
8px
radius
滚动条圆角
number | string
-
8px
事件 Events
事件名
说明
回调参数
版本说明
update:modelValue
滚动偏移量更新
(value: number) => void
drag-start
拖拽滚动块开始
void
drag-end
拖拽滚动块结束
void
纵向滚动条
横向滚动条
属性 Props
事件 Events