angela · documentación
Botón
Acciones con <button> y navegación con <a>, con variantes, tonos y tamaños.
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
<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
| Clase o atributo | Uso |
|---|---|
data-variant | solid (defecto) · soft · outline · ghost |
data-tone | brand (defecto) · neutral · success · warning · danger · info |
data-size | sm · md (defecto) · lg |
data-icon-only | Botón cuadrado solo con ícono. Requiere aria-label. |
data-block | Ocupa todo el ancho disponible. |
aria-pressed | true/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.