element/examples/docs/es/steps.md

161 lines
6.1 KiB
Markdown
Raw Normal View History

2017-11-06 19:22:02 +08:00
## Steps
2017-11-14 07:01:34 +08:00
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.
2017-11-06 19:22:02 +08:00
2017-11-14 07:01:34 +08:00
### Uso básico
2017-11-06 19:22:02 +08:00
2017-11-14 07:01:34 +08:00
Barra de pasos simple.
2017-11-06 19:22:02 +08:00
2017-11-14 07:01:34 +08:00
:::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 `Boolean`. 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.
2017-11-06 19:22:02 +08:00
```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>
```
:::
2017-11-14 07:01:34 +08:00
### Step bar con el status
2017-11-06 19:22:02 +08:00
2017-11-14 07:01:34 +08:00
Muestra el estado del step para cada paso.
2017-11-06 19:22:02 +08:00
2017-11-14 07:01:34 +08:00
:::demo Utilice el atributo `title` para establecer el nombre del paso, o sobreescriba el atributo usando un slot con nombre. Hemos enumerado todos los nombres de slots al final de esta página.
2017-11-06 19:22:02 +08:00
```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>
```
:::
2017-11-14 07:01:34 +08:00
### Centrado
2017-11-06 19:22:02 +08:00
2017-11-14 07:01:34 +08:00
El título y la descripción pueden estar centrados.
2017-11-06 19:22:02 +08:00
:::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>
```
:::
2017-11-14 07:01:34 +08:00
### Step bar con descripción
2017-11-06 19:22:02 +08:00
2017-11-14 07:01:34 +08:00
Puede poner una descripción para cada paso.
2017-11-06 19:22:02 +08:00
:::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
2017-11-14 07:01:34 +08:00
En la barra de pasos se pueden utilizar diversos iconos personalizados.
2017-11-06 19:22:02 +08:00
2017-11-14 07:01:34 +08:00
:::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.
2017-11-06 19:22:02 +08:00
```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>
```
:::
2017-11-14 07:01:34 +08:00
### Step bar vertical
2017-11-06 19:22:02 +08:00
2017-11-14 07:01:34 +08:00
Step bar vertical.
2017-11-06 19:22:02 +08:00
2017-11-14 07:01:34 +08:00
:::demo Sólo tiene que fijar el atributo `direction` a ` vertical` en el elemento `el-steps`.
2017-11-06 19:22:02 +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>
```
:::
2017-11-14 07:01:34 +08:00
### Step bar simple
Step bar simple, donde se ignorará `align-center`, `description`, `direction` y `space`.
2017-11-06 19:22:02 +08:00
:::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>
```
:::
2017-11-14 07:01:34 +08:00
### Steps atributos
| Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
| -------------- | ---------------------------------------- | --------------- | ---------------------------------------- | ----------- |
| space | el espaciado de cada paso, será responsivo si se omite. Soporta porcentaje. | number / string | — | — |
| direction | dirección de visualización | string | vertical/horizontal | horizontal |
| active | actual paso de activación | number | — | 0 |
| process-status | status del paso actual | string | wait / process / finish / error / success | process |
| finish-status | status 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 |
### Step atributos
| 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 | - | |
2017-11-06 19:22:02 +08:00
### Step Slot
2017-11-14 07:01:34 +08:00
| Name | Description |
| ----------- | -------------------- |
| icon | Icono personalizado |
| title | Titulo del paso |
| description | Descripcion del paso |
2017-11-06 19:22:02 +08:00