Skip to content

H5预览

APP下载

Slider 滑块

一个可交互的滑块组件,用于在指定范围内选择数值。

参数

参数说明类型可选值默认值
pt样式穿透配置PassThrough--
modelValue绑定的当前值number-0
max可选择的最大值number-100
min可选择的最小值number-0
step滑动步长number-1
disabled是否禁用滑块boolean-false
blockSize滑块手柄大小(px)number-20
showValue是否显示当前值boolean-false

事件

事件名称说明回调参数
change滑块值变化时触发的事件(value: number) => void

PassThrough

样式穿透配置对象,用于深度自定义组件内部元素的样式。

参数说明类型
className组件根元素样式string
track滑块轨道配置PassThroughProps
progress滑块进度条配置PassThroughProps
thumb滑块手柄配置PassThroughProps
value显示数值标签配置PassThroughProps

示例

基本用法

最简单的滑块使用方式:

html
<cl-slider></cl-slider>

显示当前值

在滑块上方显示当前选择的数值:

html
<cl-slider show-value></cl-slider>

设置步长

设置滑块的移动步长为 10:

html
<cl-slider :step="10"></cl-slider>

自定义范围

设置滑块的最大值为 50:

html
<cl-slider :max="50"></cl-slider>

禁用状态

禁用滑块,阻止用户交互:

html
<cl-slider disabled></cl-slider>