mirror of
https://github.com/ant-design/ant-design.git
synced 2024-11-25 19:50:05 +08:00
2d2d9f60c4
* feat: support type nav style * fix: some style for review issue * fix: active hover style * chore: use navigation and upgrade rc-steps * feat: support disabled prop for Steps.Step * feat: support subTitle and improve code style * fix: navigation steps item style * test: update snap test case * fix: test steps snapshots and review style issue * fix: lint issue * fix: lint style issue of steps * fix: update steps demo for review issue * fix: steps nav style detail * fix: steps nav fix style detail * fix: Steps subtitle overflow style in firefox * docs: fix Steps new api doc
2.4 KiB
2.4 KiB
| category | type | cols | title |
|---|---|---|---|
| Components | Navigation | 1 | Steps |
Steps is a navigation bar that guides users through the steps of a task.
When To Use
When the task is complicated or has a certain sequence in the series of subtasks, we can decompose it into several steps to make things easier.
API
<Steps>
<Step title="first step" />
<Step title="second step" />
<Step title="third step" />
</Steps>
Steps
The whole of the step bar.
| Property | Description | Type | Default | Version |
|---|---|---|---|---|
| className | additional class to Steps | string | - | 3.11.3 |
| type | type of steps, can be set to one of the following values: default, navigation |
string | default |
3.22.0 |
| current | to set the current step, counting from 0. You can overwrite this state by using status of Step |
number | 0 | |
| direction | to specify the direction of the step bar, horizontal or vertical |
string | horizontal |
|
| labelPlacement | place title and description with horizontal or vertical direction |
string | horizontal |
3.7.3 |
| progressDot | Steps with progress dot style, customize the progress dot by setting it to a function. labelPlacement will be vertical |
Boolean or (iconDot, {index, status, title, description}) => ReactNode | false | |
| size | to specify the size of the step bar, default and small are currently supported |
string | default |
|
| status | to specify the status of current step, can be set to one of the following values: wait process finish error |
string | process |
|
| initial | set the initial step, counting from 0 | number | 0 | 3.9.0 |
| onChange | Trigger when Step click to change | (current) => void | - | 3.19.0 |
Steps.Step
A single step in the step bar.
| Property | Description | Type | Default | Version |
|---|---|---|---|---|
| description | description of the step, optional property | string|ReactNode | - | |
| icon | icon of the step, optional property | string|ReactNode | - | |
| status | to specify the status. It will be automatically set by current of Steps if not configured. Optional values are: wait process finish error |
string | wait |
|
| title | title of the step | string|ReactNode | - | |
| subTitle | subTitle of the step | string|ReactNode | - | 3.22.0 |
| disabled | disable click | boolean | false | 3.22.0 |