2020-08-13 15:18:26 +08:00
## Steps
Guía al usuario para completar tareas de acuerdo con el proceso. Sus pasos pueden configurarse de acuerdo con el escenario de aplicación real y el número de pasos no puede ser inferior a dos.
### Uso básico
Barra de pasos simple.
:::demo Defina el atributo `active` con un valor de tipo `Number` , que indica el índice de pasos y comienza desde 0. Puede definir el atributo `space` cuando es necesario fijar el ancho del paso que acepta el tipo `Number` . La unidad del atributo `space` es px. Si no está configurado, es responsive. La configuración del atributo `finish-status` puede cambiar el estado de los pasos completados.
```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 {
2021-09-04 19:29:28 +08:00
active: 0,
}
2020-08-13 15:18:26 +08:00
},
methods: {
next() {
2021-09-04 19:29:28 +08:00
if (this.active++ > 2) this.active = 0
},
},
2020-08-13 15:18:26 +08:00
}
< / script >
```
2021-09-04 19:29:28 +08:00
2020-08-13 15:18:26 +08:00
:::
### Step bar con el estatus
Muestra el estado del step para cada paso.
:::demo Utilice el atributo `title` para establecer el nombre del paso, o sobrescriba el atributo usando un slot con nombre. Hemos enumerado todos los nombres de slots al final de esta página.
```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 >
```
2021-09-04 19:29:28 +08:00
2020-08-13 15:18:26 +08:00
:::
### Centrado
El título y la descripción pueden estar centrados.
:::demo
2021-09-04 19:29:28 +08:00
2020-08-13 15:18:26 +08:00
```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 >
```
2021-09-04 19:29:28 +08:00
2020-08-13 15:18:26 +08:00
:::
### Step bar con descripción
Puede poner una descripción para cada paso.
:::demo
2021-09-04 19:29:28 +08:00
2020-08-13 15:18:26 +08:00
```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 >
```
2021-09-04 19:29:28 +08:00
2020-08-13 15:18:26 +08:00
:::
### Step bar con icono
En la barra de pasos se pueden utilizar diversos iconos personalizados.
:::demo El icono se define mediante la propiedad `icon` . Los tipos de iconos se pueden encontrar en la descripción del componente Icono. Además, puede personalizar el icono a través de un slot con nombre.
```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 >
```
2021-09-04 19:29:28 +08:00
2020-08-13 15:18:26 +08:00
:::
### Step bar vertical
Step bar vertical.
2021-09-04 19:29:28 +08:00
:::demo Sólo tiene que fijar el atributo `direction` a ` vertical` en el elemento `el-steps` .
2020-08-13 15:18:26 +08:00
```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 >
```
2021-09-04 19:29:28 +08:00
2020-08-13 15:18:26 +08:00
:::
### Step bar simple
2021-09-04 19:29:28 +08:00
2020-08-13 15:18:26 +08:00
Step bar simple, donde se ignorará `align-center` , `description` , `direction` y `space` .
:::demo
2021-09-04 19:29:28 +08:00
```html
2020-08-13 15:18:26 +08:00
< 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" >
2021-09-04 19:29:28 +08:00
< el-step title = "Step 1" > < / el-step >
< el-step title = "Step 2" > < / el-step >
< el-step title = "Step 3" > < / el-step >
2020-08-13 15:18:26 +08:00
< / el-steps >
```
2021-09-04 19:29:28 +08:00
2020-08-13 15:18:26 +08:00
:::
### Steps atributos
2021-09-04 19:29:28 +08:00
| Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
| -------------- | --------------------------------------------------------------------------- | --------------- | ----------------------------------------- | ----------- |
2020-08-13 15:18:26 +08:00
| space | el espaciado de cada paso, será responsivo si se omite. Soporta porcentaje. | number / string | — | — |
2021-09-04 19:29:28 +08:00
| direction | dirección de visualización | string | vertical/horizontal | horizontal |
| active | actual paso de activación | number | — | 0 |
| process-status | estatus del paso actual | string | wait / process / finish / error / success | process |
| finish-status | estatus del paso final | string | wait / process / finish / error / success | finish |
| align-center | centrado de título y descripción | boolean | — | false |
| simple | si aplicar un tema simple | boolean | - | false |
2020-08-13 15:18:26 +08:00
### Step atributos
2021-09-04 19:29:28 +08:00
| Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
| ----------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ | ----------------- | ----------- |
| title | titulo del paso | string | — | — |
| description | descripción del paso | string | — | — |
| icon | icono del paso | nombre de la clase del icono del paso. Los iconos también se pueden pasar a través del slot con nombre | string | — |
| status | estado actual. Se configurará automáticamente mediante Steps si no está configurado. | wait / process / finish / error / success | - | |
2020-08-13 15:18:26 +08:00
### Step Slot
2021-09-04 19:29:28 +08:00
2020-08-13 15:18:26 +08:00
| Name | Description |
| ----------- | -------------------- |
| icon | Icono personalizado |
| title | Titulo del paso |
| description | Descripción del paso |