59 lines
3.3 KiB
Markdown
59 lines
3.3 KiB
Markdown
---
|
|
category: Components
|
|
type: Navigation
|
|
cols: 1
|
|
title: Steps
|
|
cover: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*677sTqCpE3wAAAAAAAAAAAAADrJ8AQ/original
|
|
coverDark: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*cFsBQLA0b7UAAAAAAAAAAAAADrJ8AQ/original
|
|
---
|
|
|
|
`Steps` is a navigation bar that guides users through the steps of a task.
|
|
|
|
## API
|
|
|
|
### Steps
|
|
|
|
The whole of the step bar.
|
|
|
|
| Property | Description | Type | Default | Version |
|
|
| --- | --- | --- | --- | --- |
|
|
| current(v-model) | to set the current step, counting from 0. You can overwrite this state by using `status` of `Step`, support v-model after 1.5.0 | number | 0 | |
|
|
| direction | to specify the direction of the step bar, `horizontal` and `vertical` are currently supported | string | `horizontal` | |
|
|
| initial | set the initial step, counting from 0 | number | 0 | |
|
|
| labelPlacement | support vertical title and description | string | `horizontal` | |
|
|
| percent | Progress circle percentage of current step in `process` status (only works on basic Steps) | number | - | 3.0 |
|
|
| progressDot | Steps with progress dot style, customize the progress dot by setting a scoped slot. labelPlacement will be `vertical` | Boolean or v-slot:progressDot="{index, status, title, description, prefixCls, iconDot}" | false | |
|
|
| responsive | change to vertical direction when screen width smaller than `532px` | boolean | true | 3.0 |
|
|
| 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` | |
|
|
| type | Type of steps, can be set to one of the following values: `default`, `navigation` | string | `default` | 1.5.0 |
|
|
| items | StepItem content | [StepItem](#stepsstep) | [] | |
|
|
|
|
### `type="inline"` (4.0+)
|
|
|
|
| Property | Description | Type | Default | Version |
|
|
| --- | --- | --- | --- | --- |
|
|
| current | To set the current step, counting from 0. You can overwrite this state by using `status` of `Step` | number | 0 | |
|
|
| initial | Set the initial step, counting from 0 | number | 0 | |
|
|
| status | To specify the status of current step, can be set to one of the following values: `wait` `process` `finish` `error` | string | `process` | |
|
|
| items | StepItem content. not supported: `icon` `subtitle` | [StepItem](#stepsstep) | [] | |
|
|
|
|
#### Steps Events
|
|
|
|
| Events Name | Description | Arguments | Version | |
|
|
| ----------- | ---------------------------- | ----------------- | ------- | ----- |
|
|
| change | Trigger when Step is changed | (current) => void | - | 1.5.0 |
|
|
|
|
### Steps.Step
|
|
|
|
A single step in the step bar.
|
|
|
|
| Property | Description | Type | Default | Version |
|
|
| --- | --- | --- | --- | --- |
|
|
| description | description of the step, optional property | string\|slot | - | |
|
|
| disabled | Disable click | boolean | false | 1.5.0 |
|
|
| icon | icon of the step, optional property | string\|slot | - | |
|
|
| 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` | |
|
|
| subTitle | Subtitle of the step | string\|slot | - | 1.5.0 |
|
|
| title | title of the step | string\|slot | - | |
|