mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-25 00:08:27 +08:00
882cec62d6
* docs: Add components overview page * fix detail * remove ContributorsList form overview page * fix components url * improve code style * remove extra file * fix detail * fix lint * fix lint * docs: Finish components overview page * fix lint * docs: Update cover * fix lint * update cover * update menu * improve overview page * refactor code * fix order * update title * add components count * fix overview page ssr bug * move less file * update title margin Co-authored-by: arvinxx <arvinx@foxmail.com>
44 lines
2.6 KiB
Markdown
44 lines
2.6 KiB
Markdown
---
|
|
category: Components
|
|
type: Data Entry
|
|
title: Slider
|
|
cover: https://gw.alipayobjects.com/zos/alicdn/HZ3meFc6W/Silder.svg
|
|
---
|
|
|
|
A Slider component for displaying current value and intervals in range.
|
|
|
|
## When To Use
|
|
|
|
To input a value in a range.
|
|
|
|
## API
|
|
|
|
| Property | Description | Type | Default | Version |
|
|
| --- | --- | --- | --- | --- |
|
|
| autoFocus | get focus when component mounted | boolean | false | |
|
|
| defaultValue | The default value of slider. When `range` is `false`, use `number`, otherwise, use `[number, number]` | number\|\[number, number] | 0 or \[0, 0] | |
|
|
| disabled | If true, the slider will not be interactable. | boolean | false | |
|
|
| 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: string\|ReactNode } or { number: { style: object, label: string\|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 `marks` no null, `step` can be `null`. | number\|null | 1 | |
|
|
| tipFormatter | Slider will pass its value to `tipFormatter`, and display its value in Tooltip, and hide Tooltip when return value is null. | value => ReactNode\|null | IDENTITY | |
|
|
| 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 | |
|
|
| onAfterChange | Fire when `onmouseup` is fired. | (value) => void | NOOP | |
|
|
| onChange | Callback function that is fired when the user changes the slider's value. | (value) => void | NOOP | |
|
|
| tooltipPlacement | Set Tooltip display position. Ref [`Tooltip`](/components/tooltip/). | string | | |
|
|
| tooltipVisible | If true, Tooltip will show always, or it will not show anyway, even if dragging or hovering. | Boolean | | |
|
|
| getTooltipPopupContainer | The DOM container of the Tooltip, the default behavior is to create a div element in body. | (triggerNode) => HTMLElement | () => document.body | |
|
|
|
|
## Methods
|
|
|
|
| Name | Description | Version |
|
|
| ------- | ------------ | ------- |
|
|
| blur() | remove focus | |
|
|
| focus() | get focus | |
|