Ejemplos

Variantes

Una sola acción primaria (solid) por vista. Las demás, soft, outline o ghost.

Vista previa · colores por defecto de angela

<div class="cluster">
  <button class="button" type="button">Guardar</button>
  <button class="button" type="button" data-variant="soft">Vista previa</button>
  <button class="button" type="button" data-variant="outline">Exportar</button>
  <button class="button" type="button" data-variant="ghost">Cancelar</button>
</div>

Tonos

El color solo comunica intención o estado. data-tone cambia todos los colores del componente a la vez.

Vista previa · colores por defecto de angela

<div class="stack" style="--stack-gap: var(--space-3)">
  <div class="cluster">
    <button class="button" type="button" data-tone="brand">Marca</button>
    <button class="button" type="button" data-tone="neutral">Neutral</button>
    <button class="button" type="button" data-tone="success">Éxito</button>
    <button class="button" type="button" data-tone="warning">Aviso</button>
    <button class="button" type="button" data-tone="danger">Peligro</button>
    <button class="button" type="button" data-tone="info">Info</button>
  </div>
  <div class="cluster">
    <button class="button" type="button" data-variant="soft" data-tone="brand">Marca</button>
    <button class="button" type="button" data-variant="soft" data-tone="neutral">Neutral</button>
    <button class="button" type="button" data-variant="soft" data-tone="success">Éxito</button>
    <button class="button" type="button" data-variant="soft" data-tone="warning">Aviso</button>
    <button class="button" type="button" data-variant="soft" data-tone="danger">Peligro</button>
    <button class="button" type="button" data-variant="soft" data-tone="info">Info</button>
  </div>
</div>

Tamaños

Vista previa · colores por defecto de angela

<div class="cluster">
  <button class="button" type="button" data-size="sm">Pequeño</button>
  <button class="button" type="button">Mediano</button>
  <button class="button" type="button" data-size="lg">Grande</button>
</div>

Con ícono y solo ícono

El ícono es decorativo (aria-hidden). Un botón solo-ícono necesita aria-label con un nombre que diga qué hace.

Vista previa · colores por defecto de angela

<div class="cluster">
  <button class="button" type="button"><svg aria-hidden="true">…</svg> Nuevo cliente</button>
  <button class="button" type="button" data-variant="outline" data-tone="neutral"><svg aria-hidden="true">…</svg> Descargar</button>
  <button class="button" type="button" data-variant="ghost" data-tone="neutral" data-icon-only aria-label="Editar perfil"><svg aria-hidden="true">…</svg></button>
  <button class="button" type="button" data-variant="ghost" data-tone="danger" data-icon-only aria-label="Eliminar perfil"><svg aria-hidden="true">…</svg></button>
</div>

Estados

disabled saca el botón del orden de tabulación. aria-disabled="true" lo mantiene enfocable (útil para explicar por qué no está disponible), pero tú debes bloquear la acción en JS. aria-pressed crea un botón conmutador.

Vista previa · colores por defecto de angela

Completa la dirección para pagar.
<div class="cluster">
  <button class="button" type="button" disabled>Deshabilitado</button>
  <button class="button" type="button" aria-disabled="true" aria-describedby="pago-motivo">Pagar</button>
  <span id="pago-motivo" class="muted">Completa la dirección para pagar.</span>
  <button class="button" type="button" data-variant="outline" data-tone="neutral" aria-pressed="true">Negrita</button>
</div>

Enlace con aspecto de botón

Si lleva a otra página, es un enlace: conserva abrir en pestaña nueva, copiar URL y funciona sin JS.

Vista previa · colores por defecto de angela

<a class="button" data-variant="outline" href="#">Ver documentación</a>

API

Clases y atributos de Botón
Clase o atributoUso
data-variantsolid (defecto) · soft · outline · ghost
data-tonebrand (defecto) · neutral · success · warning · danger · info
data-sizesm · md (defecto) · lg
data-icon-onlyBotón cuadrado solo con ícono. Requiere aria-label.
data-blockOcupa todo el ancho disponible.
aria-pressedtrue/false para botones conmutadores.

Accesibilidad

  • Usa <button type="button"> para acciones y <a href> para navegar. Nunca <div onclick>.
  • Dentro de un formulario, el botón que envía es type="submit" y los demás type="button".
  • Altura mínima de 40 px (44 px en pantallas táctiles): supera el objetivo de 24 px de WCAG 2.5.8.
  • Foco visible con anillo de 2 px y contraste ≥ 3:1. En modo de alto contraste el borde transparente se vuelve visible.
  • Texto sobre el color sólido con contraste ≥ 4.5:1 para cualquier tono de la paleta.