mirror of
https://github.com/ant-design/ant-design.git
synced 2024-11-26 04:00:13 +08:00
aa97494625
* feat: change slide tooltip api * fix: deprecated warning * refactor: remove boolean type support for Slider tooltip * feat: update warning text * chore: fix typo * chore: save prod perf * test: back of test case * chore: clean up * chore: fix test require Co-authored-by: 二货机器人 <smith3816@gmail.com>
58 lines
3.2 KiB
Markdown
58 lines
3.2 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 | Whether 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 \| \[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: 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 `marks` no null, `step` can be null | number \| null | 1 | |
|
|
| 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 | |
|
|
| onAfterChange | Fire when onmouseup is fired | (value) => void | - | |
|
|
| onChange | Callback function that is fired when the user changes the slider's value | (value) => void | - | |
|
|
| trackStyle | The style of slider track | CSSProperties | - | |
|
|
| handleStyle | The style of slider handle | CSSProperties | - | |
|
|
|
|
### range
|
|
|
|
| Property | Description | Type | Default | Version |
|
|
| -------------- | ------------------------------- | ------- | ------- | ------- |
|
|
| draggableTrack | Whether range track can be drag | boolean | false | 4.10.0 |
|
|
|
|
### tooltip
|
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
| --- | --- | --- | --- | --- |
|
|
| 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 | |
|