滑块
在固定范围内拖动滑块。
基本用法
拖动滑块时会显示当前值。
通过设置绑定值来自定义滑块的初始值。
离散值
这些选项可以是离散的。
使用 step 属性设置步长。您可以通过设置 show-stops 属性来显示断点。
带输入框的滑块
通过输入框设置值。
设置show-input属性以在右侧显示输入框。
尺寸
安置
您可以自定义工具提示的位置。
范围选择
支持选择一个值范围。
设置 range 属性会激活范围模式,其中绑定值是由两个边界值组成的数组。
垂直模式
将 vertical 属性设置为 true 启用垂直模式。在垂直模式下,需要 height 属性。
显示标记
设置此 marks 属性可以在滑块上显示标记。
限制值 2.13.6
设置 step="mark" 将滑块值限制为标记。
API
属性
|名称 |描述 |类型 |默认 | | ------------------------ | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | |模型值 / v 模型 |绑定值| 数字 / 数组 | 0 | |分钟|最小值| 数字 | 0 | |最大|最大值| 数字 | 100 | 100 |已禁用 | Slider 是否被禁用 | 布尔值 |假 | |步骤|步长,可以是数字或 'mark' 2.13.6 以将值限制为标记。当设置为 'mark' 时,必须设置 marks 属性 | 数字 / 字符串 | 1 | |显示输入 |是否显示输入框,当 range 为 false 且 step 不是 'mark' 时有效 | 布尔值 |假 | |显示输入控件 |当show-input为true时是否显示控制按钮| 布尔值 |真实 | |尺寸|滑块包装器的大小,在垂直模式下不起作用 | 枚举 |默认 | |输入大小 |输入框的大小,设置size时,默认为size | 的值枚举 |默认 | |演出站点 |是否显示断点| 布尔值 |假 | |显示工具提示 |是否显示工具提示值| 布尔值 |真实 | |格式工具提示 |显示工具提示值的格式 | 功能 | — | |范围 |是否选择范围| 布尔值 |假 | |垂直|垂直模式| 布尔值 |假 | |高度|滑块高度,垂直模式下需要 | 字符串 | — | |咏叹调标签 a11y 2.7.2 |原生 aria-label 属性 | 字符串 | — | |范围开始标签 |当 range 为 true 时,范围开始的屏幕阅读器标签 | 字符串 | — | |范围结束标签 |当 range 为 true 时,屏幕阅读器标签为范围末尾 | 字符串 | — | |格式值文本 |为屏幕阅读器显示 aria-valuenow 属性的格式 | 功能 | — | |工具提示类 |工具提示的自定义类名 | 字符串 | — | |安置 |工具提示的位置 | 枚举 |顶部 | |标记|标记,key类型必须为number且必须为闭区间[min, max],每个标记可以自定义样式| 对象 | — | |验证事件 |是否触发表单验证 | 布尔值 |真实 | |持久 2.9.5 |当滑块工具提示处于非活动状态且 persistent 为 false 时,工具提示将被销毁。当 show-tooltip 为 false 时,persistent 始终为 false | 布尔值 |真实 | |标签 a11y 已弃用 |原生 aria-label 属性 | 字符串 | — |
活动
| 名称 | 描述 | 类型 |
|---|---|---|
| 改变 | 当值改变时触发(如果鼠标被拖动,该事件仅在释放鼠标时触发) | 功能 |
| 输入 | 数据变化时触发(滑动时实时发出) | 功能 |
类型声明
显示声明
type SliderMarks = Record<number, string | { style: CSSProperties; label: any }>
type Arrayable<T> = T | T[]