mirror of
https://gitee.com/ant-design/ant-design.git
synced 2024-12-05 05:28:20 +08:00
92 lines
4.8 KiB
Markdown
92 lines
4.8 KiB
Markdown
---
|
||
category: Components
|
||
group: Data Entry
|
||
title: Slider
|
||
description: A Slider component for displaying current value and intervals in range.
|
||
cover: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*_4heQaUrFn4AAAAAAAAAAAAADrJ8AQ/original
|
||
coverDark: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*XkgXTaudeosAAAAAAAAAAAAADrJ8AQ/original
|
||
demo:
|
||
cols: 2
|
||
---
|
||
|
||
## When To Use
|
||
|
||
To input a value in a range.
|
||
|
||
## Examples
|
||
|
||
<!-- prettier-ignore -->
|
||
<code src="./demo/basic.tsx">Basic</code>
|
||
<code src="./demo/input-number.tsx">Slider with InputNumber</code>
|
||
<code src="./demo/icon-slider.tsx">Slider with icon</code>
|
||
<code src="./demo/tip-formatter.tsx">Customize tooltip</code>
|
||
<code src="./demo/event.tsx">Event</code>
|
||
<code src="./demo/mark.tsx">Graduated slider</code>
|
||
<code src="./demo/vertical.tsx">Vertical</code>
|
||
<code src="./demo/show-tooltip.tsx">Control visible of ToolTip</code>
|
||
<code src="./demo/reverse.tsx">Reverse</code>
|
||
<code src="./demo/draggableTrack.tsx">Draggable track</code>
|
||
<code src="./demo/multiple.tsx">Multiple handles</code>
|
||
<code src="./demo/editable.tsx" version="5.20.0">Dynamic edit nodes</code>
|
||
<code src="./demo/component-token.tsx" debug>Component Token</code>
|
||
|
||
## API
|
||
|
||
Common props ref：[Common props](/docs/react/common-props)
|
||
|
||
| Property | Description | Type | Default | Version |
|
||
| --- | --- | --- | --- | --- |
|
||
| autoFocus | Whether get focus when component mounted | boolean | false | |
|
||
| classNames | Semantic structure className | [Record<SemanticDOM, string>](#semantic-dom) | - | 5.10.0 |
|
||
| defaultValue | The default value of slider. When `range` is false, use number, otherwise, use \[number, number] | number \| \[number, number] | 0 \| \[0, 0] | |
|
||
| disabled | If true, the slider will not be intractable | boolean | false | |
|
||
| keyboard | Support using keyboard to move handlers | boolean | true | 5.2.0+ |
|
||
| dots | Whether the thumb can drag over tick only | boolean | false | |
|
||
| included | Make effect when `marks` not null, true means containment and false means coordinative | boolean | true | |
|
||
| marks | Tick mark of Slider, type of key must be `number`, and must in closed interval \[min, max], each mark can declare its own style | object | { number: ReactNode } \| { number: { style: CSSProperties, label: ReactNode } } | |
|
||
| max | The maximum value the slider can slide to | number | 100 | |
|
||
| min | The minimum value the slider can slide to | number | 0 | |
|
||
| range | Dual thumb mode | boolean | false | |
|
||
| reverse | Reverse the component | boolean | false | |
|
||
| step | The granularity the slider can step through values. Must greater than 0, and be divided by (max - min) . When `step` is `null` but exist `marks`, the valid point will only be the `mark`, `min` and `max` | number \| null | 1 | |
|
||
| styles | Semantic structure style | [Record<SemanticDOM, React.CSSProperties>](#semantic-dom) | - | 5.10.0 |
|
||
| tooltip | The tooltip relate props | [tooltip](#tooltip) | - | 4.23.0 |
|
||
| value | The value of slider. When `range` is false, use number, otherwise, use \[number, number] | number \| \[number, number] | - | |
|
||
| vertical | If true, the slider will be vertical | boolean | false | |
|
||
| onChangeComplete | Fire when `mouseup` or `keyup` is fired | (value) => void | - | |
|
||
| onChange | Callback function that is fired when the user changes the slider's value | (value) => void | - | |
|
||
|
||
### range
|
||
|
||
| Property | Description | Type | Default | Version |
|
||
| --- | --- | --- | --- | --- |
|
||
| draggableTrack | Whether range track can be drag | boolean | false | - |
|
||
| editable | Dynamic edit nodes, can't be used with `draggableTrack` | boolean | false | 5.20.0 |
|
||
| minCount | The minimum count of nodes | number | 0 | 5.20.0 |
|
||
| maxCount | The maximum count of nodes | number | - | 5.20.0 |
|
||
|
||
### tooltip
|
||
|
||
| Property | Description | Type | Default | Version |
|
||
| --- | --- | --- | --- | --- |
|
||
| autoAdjustOverflow | Whether to automatically adjust the popup position | boolean | true | 5.8.0 |
|
||
| open | If true, Tooltip will show always, or it will not show anyway, even if dragging or hovering | boolean | - | 4.23.0 |
|
||
| placement | Set Tooltip display position. Ref [Tooltip](/components/tooltip/) | string | - | 4.23.0 |
|
||
| getPopupContainer | The DOM container of the Tooltip, the default behavior is to create a div element in body | (triggerNode) => HTMLElement | () => document.body | 4.23.0 |
|
||
| formatter | Slider will pass its value to `formatter`, and display its value in Tooltip, and hide Tooltip when return value is null | value => ReactNode \| null | IDENTITY | 4.23.0 |
|
||
|
||
## Methods
|
||
|
||
| Name | Description | Version |
|
||
| ------- | ------------ | ------- |
|
||
| blur() | Remove focus | |
|
||
| focus() | Get focus | |
|
||
|
||
## Semantic DOM
|
||
|
||
<code src="./demo/_semantic.tsx" simplify="true"></code>
|
||
|
||
## Design Token
|
||
|
||
<ComponentTokenTable component="Slider"></ComponentTokenTable>
|