滑块

在固定范围内拖动滑块。

基本用法

拖动滑块时会显示当前值。

通过设置绑定值来自定义滑块的初始值。

Default value
Customized initial value
Hide Tooltip
Format Tooltip
Disabled

离散值

这些选项可以是离散的。

使用 step 属性设置步长。您可以通过设置 show-stops 属性来显示断点。

Breakpoints not displayed
Breakpoints displayed

带输入框的滑块

通过输入框设置值。

设置show-input属性以在右侧显示输入框。

尺寸

安置

您可以自定义工具提示的位置。

范围选择

支持选择一个值范围。

设置 range 属性会激活范围模式,其中绑定值是由两个边界值组成的数组。

垂直模式

vertical 属性设置为 true 启用垂直模式。在垂直模式下,需要 height 属性。

显示标记

设置此 marks 属性可以在滑块上显示标记。

0°C
8°C
37°C
50%

限制值 2.13.6

设置 step="mark" 将滑块值限制为标记。

0°C
37°C
100°C
0cm
10cm
25cm
50cm
75cm
100cm
0
13
42
58
89
100

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 |当滑块工具提示处于非活动状态且 persistentfalse 时,工具提示将被销毁。当 show-tooltip false 时,persistent 始终为 false | 布尔值 |真实 | |标签 a11y 已弃用 |原生 aria-label 属性 | 字符串 | — |

活动

名称描述类型
改变当值改变时触发(如果鼠标被拖动,该事件仅在释放鼠标时触发)功能
输入数据变化时触发(滑动时实时发出)功能

类型声明

显示声明
ts
type SliderMarks = Record<number, string | { style: CSSProperties; label: any }>
type Arrayable<T> = T | T[]