Tui

Slider 滑块
通过滑动改变数值的组件,支持水平/垂直、圆角、小球、百分比模式等多种配置。
基础用法
通过 v-model 绑定数值,默认水平滑动。
Default Value
No Ball Value
Disabled Value
示例代码
vue
垂直模式
支持垂直方向滑动。
当前值:50
示例代码
vue
范围与样式
合并演示 range、min/max、radius、trackBg、fillBg,避免重复示例。
范围选择:[ 30, 40 ]
radius + trackBg:30
示例代码
vue
step + 小数 + Tooltip
合并演示 step、decimals、ballTooltip(effect/formatter)。
单值:step=0.1,当前值 5.1
范围:step=0.2,当前值 2.4 / 7.6
示例代码
vue
Hover 百分比回调
通过 hover 事件获取当前悬浮位置对应的值与百分比。
当前值:30
hover 值:30
hover 百分比:30%
示例代码
vue
属性 Props
属性名
说明
类型
可选值
默认值
版本说明
modelValue
绑定的值
number | number[]
0 ~ max 或 0 ~ 100
-
value
当前值, 受控
number
0 ~ max 或 0 ~ 100
-
新增 0.3.7
min
最小值
number
-
0
max
最大值
number
-
100
radius
滑块radius
number
value
added 0.5.7
ball
是否显示滑块小球
boolean
true / false
true
vertical
是否垂直滑动
boolean
true / false
false
decimals
小数位数,支持 0~10(例如 1 位可得到 5.1、5.2)
number
0 ~ 10
2
step
步进值,0 表示连续;如 0.1 可得到 5.1、5.2
number
>= 0
0
added 0.6.6
ballTooltip
滑块小球悬浮提示,可传 true/false 或 TsTooltip 配置对象(支持 effect)
boolean | { effect?: 'light' | 'dark'; placements?: string[]; gap?: number; offset?: [number, number]; arrow?: boolean; nowrap?: boolean; formatter?: (value, index) => string | number }
-
false
added 0.6.6
trackBg
轨道背景颜色
string
-
added 0.6.4
fillBg
已填充区域颜色
string
-
added 0.6.4
mode
显示模式,可选数值或百分比
string
value / percent
value
deprecated 0.3.7
round
是否圆角
boolean
true / false
true
deprecated 0.5.7
事件 Events
事件名
说明
回调参数
版本说明
change
值变化时触发
(value: number | number[]) => void
hover-change
鼠标悬浮在滑轨上时触发
(payload: { percentage: number; value: number }) => void
基础用法
垂直模式
范围与样式
step + 小数 + Tooltip
Hover 百分比回调
属性 Props
事件 Events