Button
Dispara una acción. Es un <button class="ts button …">, o un <a class="ts button …" href> cuando tiene que navegar. Trae variantes, tamaños, formas, estados (disabled/loading) e íconos.
Formularios · TaishoDS Core, en HTML plano.
Ejemplos
Un ejemplo por caso, funcionando. Cada ejemplo es el HTML de su vista previa: se copia tal cual y, con el CSS y el JS del Core cargados, se ve y funciona igual.
Acción principal
Acción secundaria
Acción destructiva
Acción no disponible
Referencia de clases
Todos los valores de cada modificador, con su HTML listo para copiar.
Tamaño
El alto del botón. lg (48px) alcanza el tap target táctil; xs, sm y md quedan por debajo. xs (24px) es el botón de ícono que va dentro de otros componentes (limpiar un campo, cerrar un Tag).
Variante
La jerarquía visual: primary para la acción principal, secondary y tertiary de apoyo, ghost sin fondo, danger para lo destructivo. Con is-color-inherit, el botón toma el color de su contenedor.
Forma
La forma: default, pill, o square y circle para botones de sólo ícono.
Densidad
El aire interno: compact aprieta el alto, comfortable lo afloja.
Estados
disabled (atributo nativo) bloquea la interacción y saca el botón del orden de tabulación. loading (is-loading con aria-busy y aria-disabled; setButtonLoading los pone) lo deja enfocable pero sin activarse, y suma «Cargando» para el lector de pantalla.
Combinaciones
Varios modificadores juntos, en casos reales.
Cuándo usarlo
- Ejecutar una acción: enviar, guardar, abrir un overlay, confirmar.
- Hace falta jerarquía entre acciones (primary/secondary/ghost/danger).
- Es un enlace que tiene que verse como botón: se escribe
<a class="ts button …" href>.
Cuándo no
- Es sólo navegación en medio de un texto →
link. - Es un on/off que aplica al instante →
toggle. - Son varias acciones agrupadas detrás de un disparador →
menu.
Cómo usarlo
- Una acción primaria por contexto; el resto, secundarias.
- Botón de sólo ícono: lleva
aria-label; el texto nombra la acción. - Si se toca en mobile, conviene el tamaño
lg(48px de alto):smymdquedan por debajo del tap target mínimo de 48×48 recomendado para touch.
Cómo no usarlo
- No se ponen cinco botones primarios: dejan de guiar.
- No se usa un botón para navegar como si fuera texto →
link.
TaishoDS Core
No necesita JavaScript: es marcado y CSS.
Es un <button> nativo: foco, teclado y envío de formularios los resuelve el navegador. El JS del Core es opcional y sólo cubre el estado de carga: un botón o enlace con aria-disabled="true" no se activa (ni el click, ni Enter o Espacio, ni el envío de un formulario) aunque siga enfocable, y setButtonLoading() pone todo el estado de carga junto, con el texto «Cargando» para el lector de pantalla en el idioma de la página.
| Atributo | Qué hace |
|---|---|
setButtonLoading(button, true | false) | Pone is-loading, aria-busy, aria-disabled y el texto «Cargando» (el idioma sale del lang de la página; setTexts lo cambia con buttonLoading). El botón sigue enfocable, pero no se activa. Al terminar lo quita todo. |
aria-disabled="true" | En el botón o el enlace: lo deja enfocable pero sin activarse. disabled (en un <button>) además lo saca del orden de tabulación. |
Sin build, desde el CDN: taisho.button.css, además de taisho.base.css. También se carga:
taisho.spinner.css
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
- Foco visible vía
:focus-visible(el anillo de foco aparece solo con el teclado, no al hacer clic con el mouse). - Un
<a class="ts button" href>es un enlace: lleva rol link (norole="button"), navega y se activa con Enter, no con Espacio. - Con
setButtonLoading(boton, true)el botón queda conis-loading,aria-busy="true"yaria-disabled="true": sigue enfocable, pero no se activa (ni el click, ni Enter o Espacio, ni el envío de un formulario). El Spinner es decorativo (aria-hidden) y el lector de pantalla oye «Cargando» (o «Loading») antes del texto del botón, según el idioma de la página. La clase sola sólo cambia el aspecto: el texto queda invisible pero mide lo mismo, así no salta el layout. disabledtambién aplicaaria-disabledcuando se renderiza como<a>(los enlaces no tienendisablednativo).
Verificación
Qué se probó de verdad. Lo que no se probó lo dice: preferimos un «sin verificar» a una afirmación de más.
- axe WCAG 2.2 A + AA en navegador real, en tema claro y oscuro, antes de cada versión.
- teclado No agrega teclas propias: usa el comportamiento nativo del navegador.
- lector de pantalla Sin verificar con lector de pantalla. Conviene probarlo en la combinación de componentes propia, no sólo aquí, donde cada uno aparece solo y en su estado feliz.