mirror of
https://github.com/element-plus/element-plus.git
synced 2024-12-27 03:01:14 +08:00
87a16f24d3
* chore: add components-helper * docs: unified style * docs: unified style * docs: unified style * docs: unified style * chore: replace Accepted Values for icon * chore: delete vetur folder * chore: add components-helper * docs: unified style * docs: unified style * docs: unified style * docs: unified style * chore: replace Accepted Values for icon * chore: delete vetur folder
161 lines
5.0 KiB
Markdown
161 lines
5.0 KiB
Markdown
## Steps
|
|
|
|
Guide the user to complete tasks in accordance with the process. Its steps can be set according to the actual application scenario and the number of the steps can't be less than 2.
|
|
|
|
### Basic usage
|
|
|
|
Simple step bar.
|
|
|
|
:::demo Set `active` attribute with `Number` type, which indicates the index of steps and starts from 0. You can set `space` attribute when the width of the step needs to be fixed which accepts `Number` type. The unit of the `space` attribute is `px`. If not set, it is responsive. Setting the `finish-status` attribute can change the state of the steps that have been completed.
|
|
|
|
```html
|
|
<el-steps :active="active" finish-status="success">
|
|
<el-step title="Step 1"></el-step>
|
|
<el-step title="Step 2"></el-step>
|
|
<el-step title="Step 3"></el-step>
|
|
</el-steps>
|
|
|
|
<el-button style="margin-top: 12px;" @click="next">Next step</el-button>
|
|
|
|
<script>
|
|
export default {
|
|
data() {
|
|
return {
|
|
active: 0
|
|
};
|
|
},
|
|
|
|
methods: {
|
|
next() {
|
|
if (this.active++ > 2) this.active = 0;
|
|
}
|
|
}
|
|
}
|
|
</script>
|
|
```
|
|
:::
|
|
|
|
### Step bar that contains status
|
|
|
|
Shows the status of the step for each step.
|
|
|
|
:::demo Use `title` attribute to set the name of the step, or override the attribute by using a named `slot`. We have listed all the slot names for you at the end of this page.
|
|
|
|
```html
|
|
<el-steps :space="200" :active="1" finish-status="success">
|
|
<el-step title="Done"></el-step>
|
|
<el-step title="Processing"></el-step>
|
|
<el-step title="Step 3"></el-step>
|
|
</el-steps>
|
|
```
|
|
:::
|
|
|
|
### Center
|
|
|
|
Title and desription can be centered.
|
|
|
|
:::demo
|
|
```html
|
|
<el-steps :active="2" align-center>
|
|
<el-step title="Step 1" description="Some description"></el-step>
|
|
<el-step title="Step 2" description="Some description"></el-step>
|
|
<el-step title="Step 3" description="Some description"></el-step>
|
|
<el-step title="Step 4" description="Some description"></el-step>
|
|
</el-steps>
|
|
```
|
|
:::
|
|
|
|
### Step bar with description
|
|
|
|
There is description for each step.
|
|
|
|
:::demo
|
|
```html
|
|
<el-steps :active="1">
|
|
<el-step title="Step 1" description="Some description"></el-step>
|
|
<el-step title="Step 2" description="Some description"></el-step>
|
|
<el-step title="Step 3" description="Some description"></el-step>
|
|
</el-steps>
|
|
```
|
|
:::
|
|
|
|
### Step bar with icon
|
|
|
|
A variety of custom icons can be used in the step bar.
|
|
|
|
:::demo The icon is set by the `icon` property. The types of icons can be found in the document for the Icon component. In addition, you can customize the icon through a named `slot`.
|
|
|
|
```html
|
|
<el-steps :active="1">
|
|
<el-step title="Step 1" icon="el-icon-edit"></el-step>
|
|
<el-step title="Step 2" icon="el-icon-upload"></el-step>
|
|
<el-step title="Step 3" icon="el-icon-picture"></el-step>
|
|
</el-steps>
|
|
```
|
|
:::
|
|
|
|
### Vertical step bar
|
|
|
|
Vertical step bars.
|
|
|
|
:::demo You only need to set the `direction` attribute to` vertical` in the `el-steps` element.
|
|
|
|
```html
|
|
<div style="height: 300px;">
|
|
<el-steps direction="vertical" :active="1">
|
|
<el-step title="Step 1"></el-step>
|
|
<el-step title="Step 2"></el-step>
|
|
<el-step title="Step 3"></el-step>
|
|
</el-steps>
|
|
</div>
|
|
```
|
|
:::
|
|
|
|
### Simple step bar
|
|
Simple step bars, where `align-center`, `description`, `direction` and `space` will be ignored.
|
|
|
|
:::demo
|
|
```html
|
|
|
|
<el-steps :space="200" :active="1" simple>
|
|
<el-step title="Step 1" icon="el-icon-edit"></el-step>
|
|
<el-step title="Step 2" icon="el-icon-upload"></el-step>
|
|
<el-step title="Step 3" icon="el-icon-picture"></el-step>
|
|
</el-steps>
|
|
|
|
<el-steps :active="1" finish-status="success" simple style="margin-top: 20px">
|
|
<el-step title="Step 1" ></el-step>
|
|
<el-step title="Step 2" ></el-step>
|
|
<el-step title="Step 3" ></el-step>
|
|
</el-steps>
|
|
```
|
|
:::
|
|
|
|
### Steps Attributes
|
|
|
|
| Attribute | Description | Type | Accepted Values | Default |
|
|
|---------- |-------- |---------- |------------- |-------- |
|
|
| space | the spacing of each step, will be responsive if omitted. Supports percentage. | number / string | — | — |
|
|
| direction | display direction | string | vertical/horizontal | horizontal |
|
|
| active | current activation step | number | — | 0 |
|
|
| process-status | status of current step | string | wait / process / finish / error / success | process |
|
|
| finish-status | status of end step | string | wait / process / finish / error / success | finish |
|
|
| align-center | center title and description | boolean | — | false |
|
|
| simple | whether to apply simple theme | boolean | - | false |
|
|
|
|
### Step Attributes
|
|
| Attribute | Description | Type | Accepted Values | Default |
|
|
|---------- |-------- |---------- |------------- |-------- |
|
|
| title | step title | string | — | — |
|
|
| description | step description | string | — | — |
|
|
| icon | step icon's class name. Icons can be passed via named slot as well | string | — | — |
|
|
| status | current status. It will be automatically set by Steps if not configured. | string | wait / process / finish / error / success | — |
|
|
|
|
### Step Slots
|
|
| Name | Description |
|
|
|----|----|
|
|
| icon | custom icon |
|
|
| title | step title |
|
|
| description | step description |
|
|
|