mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-16 01:29:11 +08:00
4.6 KiB
4.6 KiB
category | group | title | description | cover | coverDark | demo | ||
---|---|---|---|---|---|---|---|---|
Components | Data Entry | Slider | A Slider component for displaying current value and intervals in range. | https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*_4heQaUrFn4AAAAAAAAAAAAADrJ8AQ/original | https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*XkgXTaudeosAAAAAAAAAAAAADrJ8AQ/original |
|
When To Use
To input a value in a range.
Examples
Basic
Slider with InputNumber
Slider with icon
Customize tooltip
Event
Graduated slider
Vertical
Control visible of ToolTip
Reverse
Draggable track
Multiple handles
Component Token
API
Common props ref:Common props
Property | Description | Type | Default | Version |
---|---|---|---|---|
autoFocus | Whether get focus when component mounted | boolean | false | |
classNames | Semantic structure className | Record<SemanticDOM, string> | - | 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> | - | 5.10.0 |
tooltip | The tooltip relate props | 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 | 4.10.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 | 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 |