ant-design/components/steps/index.zh-CN.md

---
category: Components
subtitle: 步骤条
type: 导航
cols: 1
title: Steps
---

引导用户按照流程完成任务的导航条。

## 何时使用

当任务复杂或者存在先后关系时，将其分解成一系列步骤，从而简化任务。

## API

```jsx
<Steps>
  <Step title="第一步" />
  <Step title="第二步" />
  <Step title="第三步" />
</Steps>
```

### Steps

整体步骤条。

| 参数 | 说明 | 类型 | 默认值 | 版本 |
| --- | --- | --- | --- | --- |
| className | 步骤条类名 | string | - |  |
| current | 指定当前步骤，从 0 开始记数。在子 Step 元素中，可以通过 `status` 属性覆盖状态 | number | 0 |  |
| direction | 指定步骤条方向。目前支持水平（`horizontal`）和竖直（`vertical`）两种方向 | string | horizontal |  |
| labelPlacement | 指定标签放置位置，默认水平放图标右侧，可选 `vertical` 放图标下方 | string | `horizontal` |  |
| progressDot | 点状步骤条，可以设置为一个 function，labelPlacement 将强制为 `vertical` | Boolean or (iconDot, {index, status, title, description}) => ReactNode | false |  |
| size | 指定大小，目前支持普通（`default`）和迷你（`small`） | string | default |  |
| status | 指定当前步骤的状态，可选 `wait` `process` `finish` `error` | string | process |  |
| initial | 起始序号，从 0 开始记数 | number | 0 |  |
| onChange | 点击切换步骤时触发 | (current) => void | - | 3.19.0 |

### Steps.Step

步骤条内的每一个步骤。

| 参数 | 说明 | 类型 | 默认值 |
| --- | --- | --- | --- |
| description | 步骤的详情描述，可选 | string\|ReactNode | - |
| icon | 步骤图标的类型，可选 | string\|ReactNode | - |
| status | 指定状态。当不配置该属性时，会使用 Steps 的 `current` 来自动指定状态。可选：`wait` `process` `finish` `error` | string | wait |
| title | 标题 | string\|ReactNode | - |
-												docs: update documentation format

											
										
										
											2016-03-31 14:17:09 +08:00
+								---
 								category: Components
-												docs: update docs details

											
										
										
											2016-09-21 11:28:38 +08:00
+								subtitle: 步骤条
-												:globe_with_meridians: site: transition component category, close #11629

											
										
										
											2018-11-04 16:20:35 +08:00
+								type: 导航
-												docs: update documentation format

											
										
										
											2016-03-31 14:17:09 +08:00
+								cols: 1
-												docs: update docs details

											
										
										
											2016-09-21 11:28:38 +08:00
+								title: Steps
-												docs: update documentation format

											
										
										
											2016-03-31 14:17:09 +08:00
+								---
-												二期组件挖坑

											
										
										
											2015-06-15 22:01:39 +08:00
-												更新组件文案

											
										
										
											2015-06-26 14:42:30 +08:00
+								引导用户按照流程完成任务的导航条。
-												rc-steps component

											
										
										
											2015-06-24 14:52:49 +08:00
 								## 何时使用
-												更新组件文案

											
										
										
											2015-06-26 14:42:30 +08:00
+								当任务复杂或者存在先后关系时，将其分解成一系列步骤，从而简化任务。
-												rc-steps component

											
										
										
											2015-06-24 14:52:49 +08:00
 								## API
-												update radio

											
										
										
											2015-07-16 18:26:17 +08:00
+								```jsx
 								<Steps>
-												update docs

											
										
										
											2016-03-04 11:46:24 +08:00
+								  <Step title="第一步" />
 								  <Step title="第二步" />
 								  <Step title="第三步" />
-												update radio

											
										
										
											2015-07-16 18:26:17 +08:00
+								</Steps>
 								```
-												update package.json

											
										
										
											2015-06-25 19:32:06 +08:00
+								### Steps
-												修改文案细节

											
										
										
											2015-07-17 09:42:09 +08:00
+								整体步骤条。
-												update package.json

											
										
										
											2015-06-25 19:32:06 +08:00
-												feat: Steps support clickable (#16773)

* support clickable

* update snapshot

* update desc

											
										
										
											2019-05-25 21:01:21 +08:00
+								| 参数 | 说明 | 类型 | 默认值 | 版本 |
 								| --- | --- | --- | --- | --- |
 								| className | 步骤条类名 | string | - |  |
 								| current | 指定当前步骤，从 0 开始记数。在子 Step 元素中，可以通过 `status` 属性覆盖状态 | number | 0 |  |
 								| direction | 指定步骤条方向。目前支持水平（`horizontal`）和竖直（`vertical`）两种方向 | string | horizontal |  |
 								| labelPlacement | 指定标签放置位置，默认水平放图标右侧，可选 `vertical` 放图标下方 | string | `horizontal` |  |
 								| progressDot | 点状步骤条，可以设置为一个 function，labelPlacement 将强制为 `vertical` | Boolean or (iconDot, {index, status, title, description}) => ReactNode | false |  |
 								| size | 指定大小，目前支持普通（`default`）和迷你（`small`） | string | default |  |
 								| status | 指定当前步骤的状态，可选 `wait` `process` `finish` `error` | string | process |  |
 								| initial | 起始序号，从 0 开始记数 | number | 0 |  |
 								| onChange | 点击切换步骤时触发 | (current) => void | - | 3.19.0 |
-												update package.json

											
										
										
											2015-06-25 19:32:06 +08:00
 								### Steps.Step
-												update steps doc

											
										
										
											2016-04-06 16:16:36 +08:00
+								步骤条内的每一个步骤。
-												update package.json

											
										
										
											2015-06-25 19:32:06 +08:00
-												docs: sort api table

											
										
										
											2017-10-25 10:25:44 +08:00
+								| 参数 | 说明 | 类型 | 默认值 |
 								| --- | --- | --- | --- |
 								| description | 步骤的详情描述，可选 | string\|ReactNode | - |
-												docs: Unify type naming (#4636)

* Unify name of ReactNode type in document

* Lowser all string type name

* Lowercase all number type name

* Lowercase all boolean type name

* Unify array type

* Lowercase all object type name

* Unify mutilple types

											
										
										
											2017-01-20 20:10:50 +08:00
+								| icon | 步骤图标的类型，可选 | string\|ReactNode | - |
-												docs: sort api table

											
										
										
											2017-10-25 10:25:44 +08:00
+								| status | 指定状态。当不配置该属性时，会使用 Steps 的 `current` 来自动指定状态。可选：`wait` `process` `finish` `error` | string | wait |
 								| title | 标题 | string\|ReactNode | - |