# Slider <small>滑块</small>

## 示例

### 尺寸

可选的尺寸 [`ui`](#props-ui) 属性值：`s` / `m`。

[[ demo src="/demo/slider/size.vue" ]]

### 只读/禁用

设置 [`readonly`](#props-readonly) 属性来使设置滑块只读，设置 [`disabled`](#props-disabled) 属性来使设置滑块禁用。

[[ demo src="/demo/slider/editable.vue" ]]

### 步进

使用 [`step`](#props-step) 属性来指定步进值，使点击调节按钮或按下 <kbd>←</kbd>、<kbd>→</kbd> 键时根据指定步进值来调整输入值。

[[ demo src="/demo/slider/steps.vue" ]]

### 范围

使用 [`max`](#props-max) / [`min`](#props-min) 属性来指定拖动范围两端的值。

[[ demo src="/demo/slider/range.vue" ]]

### 次级条

使用 [`secondary-progress`](#props-secondary-progress) 属性来指定一个次级进度条。

[[ demo src="/demo/slider/buffer.vue" ]]

### 定制内容

使用 [`thumb`](#slots-thumb) / [`tip`](#slots-tip) 插槽来自定义滑块按钮、悬浮提示等内容。

[[ demo src="/demo/slider/variant.vue" ]]

## API

### 属性

| 名称 | 类型 | 默认值 | 描述 |
| -- | -- | -- | -- |
| ``ui`` | `string=` | - | [^ui] |
| ``value`` | `*|Array<*>` | - | [^value] |
| ``secondary-progress`` | `number | Array<number>` | `0` | 次要条。 |
| ``min`` | `number` | `0` | `value` 经过 `parse` 函数处理后允许的最小值。 |
| ``max`` | `number` | `1` | `value` 经过 `parse` 函数处理后允许的最大值。 |
| ``step`` | `number` | `0` | `value` 经过 `parse` 函数处理后的步进值。 |
| ``mark`` | `boolean` | `false` | 是否显示步进标记。 |
| ``parse`` | `function` | `val => val` | 传入值处理函数。 |
| ``format`` | `function` | `val => val` | 输出值处理函数。 |

^^^ui
预设样式。

+++枚举值
| 值 | 描述 |
| -- | -- |
| `s` | 小尺寸样式。 |
| `m` | 中尺寸样式。 |
+++
^^^

^^^value
值。

默认值类型为 `number`，经过 `parse` 函数处理后值大小范围应在 `min` 和 `max` 之间。
当值为 `Array<number>` 形式时，组件则渲染多个滑块与值一一对应。

:::tip
当提供 `parse` 和 `format` 时，值可以为任意类型，但 `parse` 需要把传入值解析为 `number` 类型并返回；`format` 需要把传出值格式化成原始形式。`parse` 和 `format` 的实现只需要处理单值，组件内部会给多值的每一项分别依次调用这两个函数。
:::
^^^

### 插槽

| 名称 | 描述 |
| -- | -- |
| ``track`` | 滑轨。默认内容：横线。 |
| ``tip-label`` | 浮动提示文本。默认内容：当前 `value` 值。 |
| ``thumb`` | [^slot-thumb] |
| ``tip`` | [^slot-tip] |

^^^slot-thumb
滑块。

默认内容：圆形按钮。

+++作用域参数
| 名称 | 类型 | 描述 |
| -- | -- | -- |
| `index` | `number` | 滑块索引。 |
| `focus` | `boolean` | 滑块是否聚焦。 |
| `hover` | `boolean` | 鼠标是否悬浮。 |
| `dragging` | `boolean` | 滑块是否正在被拖动。 |
+++
^^^

^^^slot-tip
浮动提示。

默认内容：内容为 `value` 的 Tooltip 组件。

+++作用域参数
| 名称 | 类型 | 描述 |
| -- | -- | -- |
| `target` | `HTMLElement` | 滑块元素。 |
| `open` | `boolean` | 是否存在激活的滑块。 |
| `active-index` | `boolean` | 激活的滑块索引。 |
+++
^^^

### 事件

| 名称 | 描述 |
| -- | -- |
| ``input`` | [^event-input] |

^^^event-input
:::badges
`v-model`
:::

修改后触发，回调参数为 `(value: *)`。`value` 为改变后经 `format` 函数处理过的新值。
^^^