Button

Botones comúnmente usados.

Uso básico

Use type, plain,round y circle para darle estilos a los botones.

Botón deshabilitado

El atributo disabled determina si un botón está deshabilitado.

Use el atributo disabled para determinar si un botón esta deshabilitado. Acepta un valor Boolean.

Botón de enlace

WARNING

type="text" ha sido descontinuado y será eliminado en 3.0.0, considere cambiar a la nueva API.

Una nueva API del link ha sido añadido en 2.2.1, puede usar type para establecer el tema de su botón de enlace

Basic link button

Disabled link button

Botón de texto

TIP

El botón de texto ha sido actualizado con un nuevo diseño desde 2.2.0 , si quiere usar el botón como en la versión anterior, tal vez quiera revisar Link.

La API también se actualizó, porque el atributo type también representa el estilo del botón. Así que tenemos que crear una nueva API text: boolean para el botón de texto.

Botones sin borde ni fondo.

Basic text button

Background color always on

Disabled text button

Botón de icono

Use iconos para añadir más significado al botón. Se puede usar simplemente un icono o un icono con texto.

Use el atributo icon para agregar un icono. Puede encontrar la lista de iconos en el componente de iconos de Element Plus. Agregar iconos a la derecha del texto se puede conseguir con un tag <i>. También se pueden usar iconos personalizados.

Grupo de botones

Mostrar un grupo de botones puede ser usado para mostrar un grupo de operaciones similares.

Use el tag <el-button-group> para agrupar sus botones.

Botón de carga

Cuando se hace clic en un botón para descargar datos, el botón muestra un estado de carga.

Ajuste el atributo loading a true para mostrar el estado de carga.

TIP

Puede utilizar el slot loading o loadingIcon para personalizar el componente de carga

ps: el slot loading tiene mayor prioridad que loadingIcon

Tamaños

Además del tamaño predeterminado, el componente Button proporciona dos tamaños adicionales para que usted elija entre diferentes escenarios.

Use el atributo size para aplicar tamaños adicionales con large o small.

Etiqueta 2.3.4

Puede personalizar la etiqueta del elemento, Por ejemplo, botón, div, a, router-link, nuxt-link.

div
a

Color personalizado beta

Puede personalizar el color del botón.

Calcularemos automáticamente el color del hover & del activo.

API del Botón

Atributos del botón

NombreDescripciónTipoPor defecto
sizetamaño del botónenum
typetipo de botónenum
plaindetermina si es un botón planobooleanfalse
text 2.2.0determinar si es un botón de textobooleanfalse
bg 2.2.0determinar si el color de fondo del botón de texto está siempre encendidobooleanfalse
link 2.2.1determinar si es un botón de enlacebooleanfalse
rounddeterminar si es un botón redondobooleanfalse
circledetermina si es un botón circularbooleanfalse
loadingdetermina si está cargandobooleanfalse
loading-iconpersonalizar el componente de icono de cargastring / ComponentLoading
disableddesactiva el botónbooleanfalse
iconcomponente de iconostring / Component
autofocusigual que en el botón nativo autofocusbooleanfalse
native-typeigual que en el botón nativo typeenumbutton
auto-insert-spaceinserta automáticamente un espacio entre dos caracteres chinosboolean
colorcolor de botón personalizado, calcula automáticamente los colores de hover y activestring
darkmodo oscuro, que convierte automáticamente color a colores oscurosbooleanfalse
tag 2.3.4etiqueta de elemento personalizadastring / Componentbutton

Slots del botón

NombreDescripción
defaultpersonaliza el contenido por defecto
loadingpersonaliza componente de carga
iconpersonaliza el componente de icono

Exposiciones del botón

NombreDescripciónTipo
refelemento html del botónobject
sizetamaño del botónobject
typebutton typeobject
disabledbotón deshabilitadoobject
shouldAddSpacesi agrega espacioobject

API de ButtonGroup

Atributos del ButtonGroup

NombreDescripciónTipoPor defecto
sizecontrola el tamaño de los botones en este grupo de botonesenum
typecontrolar el tipo de botones en este grupo de botonesenum

Slots del ButtonGroup

NombreDescripciónSubetiquetas
defaultpersonaliza el contenido del grupo de botonesButton

Fuente

ComponentesStyleDocumentación

Contribuidores