element-plus/website/docs/es/steps.md
zazzaz f12000f9c2
feat: add website (#135)
* feat: add website

* chore: fix
2020-08-13 15:18:26 +08:00

6.3 KiB

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.

<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 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.

<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>

:::

Centrado

El título y la descripción pueden estar centrados.

:::demo

<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 con descripción

Puede poner una descripción para cada paso.

:::demo

<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 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.

<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>

:::

Step bar vertical

Step bar vertical.

:::demo Sólo tiene que fijar el atributo direction a vertical en el elemento el-steps.

<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>

:::

Step bar simple

Step bar simple, donde se ignorará align-center, description, direction y space.

:::demo


<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 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 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

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 -

Step Slot

Name Description
icon Icono personalizado
title Titulo del paso
description Descripción del paso