Comportamiento
Qué hace el JS del Core, cómo se engancha al HTML y cómo se detecta lo que pasa. El CSS pinta; este JS hace que funcione.
Qué necesita JS y qué no
De los 56 componentes, 18 funcionan
sin una línea de JS: unos porque son presentacionales y otros porque montan sobre primitivas
del navegador. Modal, Drawer y AlertDialog usan <dialog> e invoker commands: en los navegadores que los traen (Chrome 135,
Firefox 144, Safari 26.2) abren y atrapan el foco sin JS; en los que no (Safari anterior a la 26.2, también
la 17.4 del piso, y Firefox anterior a la 144) los abre el JS del Core, que ejecuta los comandos sobre el dialog.
Sin ese JS, allí el disparador no abre y hay que llamar a showModal() desde el propio código (ver Soporte de navegadores).
| Cuánto JS | Componentes | Qué significa | Ejemplos |
|---|---|---|---|
| Nada | 16 | Renderiza y queda correcto sin una línea de JS. | Badge, Button, Grid, Separator, Skeleton |
| Lo hace el navegador | 2 | Monta sobre una primitiva nativa: <dialog>, popover, <input>. | Modal, Drawer |
| Comportamiento | 29 | El Core alterna un atributo, el aria y una clase. | Tabs, Accordion, Pagination, Tooltip |
| Interacción completa | 9 | Foco, teclado, filtrado, virtualización. | Select, Combobox, DatePicker, Table, Toast |
El contrato: atributos, no clases
El comportamiento se engancha con atributos data-ts-* y nunca con
clases. Eso te deja cambiar los estilos, renombrar clases o reemplazar el CSS entero sin
romper nada de lo que funciona.
<div data-ts-tabs>
<div role="tablist">
<button role="tab" data-ts-tabs-tab data-ts-value="resumen"
aria-selected="true" tabindex="0">Resumen</button>
<button role="tab" data-ts-tabs-tab data-ts-value="facturacion"
aria-selected="false" tabindex="-1">Facturación</button>
</div>
<div role="tabpanel" data-ts-tabs-panel data-ts-value="resumen">Resumen del equipo</div>
<div role="tabpanel" data-ts-tabs-panel data-ts-value="facturacion">Facturas del mes</div>
</div>Los componentes que comparten un gesto comparten el código: Collapsible se comporta como un Accordion de un ítem, y Banner y Tag se descartan igual. Lo que cambia es el CSS, no la conducta.
| Gesto | Componentes | Atributo |
|---|---|---|
| Abrir y cerrar un panel | Accordion, Collapsible | data-ts-accordion |
| Pestañas | Tabs | data-ts-tabs |
| Grupo tipo radio | SegmentedControl | data-ts-segmented |
| Valor o tramo en un rango | Slider | data-ts-slider |
| Descartar | Banner, Tag | data-ts-dismissible |
| Mostrar u ocultar un bloque | Breadcrumbs, NavBar | data-ts-toggle |
| Copiar al portapapeles | Code | data-ts-copy |
| Brillo que sigue al puntero | Card | data-ts-spotlight |
| Sección activa al hacer scroll | Toc | data-ts-scrollspy |
| Respaldo si la imagen falla | Avatar | data-ts-avatar |
| Sumar y restar | NumberInput | data-ts-number |
| Arrastrar archivos | FileUpload | data-ts-file-upload |
| Flotante anclado | Tooltip | data-ts-tooltip-root |
| Flotante con la Popover API | Popover | popovertarget + popover |
| Paginar | Pagination | data-ts-pagination |
| Lista de opciones | Select, Combobox | data-ts-listbox |
| Buscador de acciones | CommandPalette | data-ts-command-palette |
| Menú | Menu, ContextMenu | data-ts-menu |
| Calendario | DatePicker | data-ts-date-picker |
| Ordenar y virtualizar | Table | data-ts-table |
| Colapsar navegación | Sidebar | data-ts-sidebar |
Cómo se detectan los cambios
En HTML plano no hay onchange, así que cada cambio emite un evento ts:change que burbujea. Es cancelable:
si se frena, el Core no toca el DOM y el cambio queda a cargo del código. En Table, frenarlo deja las filas como están,
pero la columna ordenada se marca igual, para que el próximo clic calcule bien la dirección.
document.addEventListener('ts:change', (e) => {
if (e.detail.component === 'tabs') console.log('pestaña:', e.detail.value);
if (e.detail.component === 'pagination') cargarPagina(e.detail.page);
// e.preventDefault() → el Core no aplica el cambio
});fetch o pintado por otro script— funciona sin volver a llamar a init().Toast: del HTML o desde tu JS
Un aviso aparece cuando pasa algo, así que tiene dos formas de dispararse. Desde el HTML: un botón con data-ts-toast-trigger="Texto" y, opcionalmente, data-ts-toast-variant.
Desde tu JS: toast(), que se importa del mismo taisho.core.js que
se carga en la página, con la URL del CDN. Se pega el contenedor del ejemplo de la página de Toast: trae los íconos de
cada variante. Sin él, el Core crea uno, pero los avisos salen sin ícono.
<script type="module">
import { toast, updateToast } from 'https://taisho.design/core/0.16.0/taisho.core.js';
toast('Guardado', { variant: 'success' });
// Con acción, y actualizando el mismo aviso
const aviso = toast('Proyecto eliminado.', { action: { label: 'Deshacer', onclick: restaurar } });
updateToast(aviso, { message: 'Proyecto restaurado.', variant: 'success' });
// Un aviso que acompaña a una promesa: carga, y éxito o error en el mismo lugar
toast.promise(guardar(), { loading: 'Guardando…', success: 'Guardado', error: 'No se pudo guardar' });
</script>Si se instaló el paquete (npm i -D @taishods/core), el mismo archivo se importa como @taishods/core/core. Para que el aviso se vea hace falta el CSS del Toast
(taisho.toast.css, o el completo).
Errores de formulario
Un campo inválido se marca con aria-invalid="true" en su control, y con eso alcanza para que se
pinte: Input, Textarea, Select, Combobox, NumberInput, DatePicker, Checkbox y Toggle lo llevan en el control; Radio, en su radiogroup. En Toggle el color de error se ve cuando está encendido. El mensaje va siempre en un ts input-hint variant-danger, dentro de un ts input-footer y enlazado con aria-describedby.
Para no escribir esos pasos a mano, conviene usar markInvalid(field, message) y clearInvalid(field). field es el control o su raíz. Si ya tenía una
ayuda, el error la reemplaza y limpiar la devuelve. Si se llama otra vez, cambia el mensaje.
<form id="nuevo-proyecto" novalidate>
<div class="ts input-wrapper">
<label class="ts input-label" for="nombre">Nombre del proyecto</label>
<div class="ts input size-md">
<input id="nombre" name="nombre" class="ts input-field">
</div>
</div>
<button class="ts button size-md variant-primary">Crear proyecto</button>
</form>
<script type="module">
import { markInvalid, clearInvalid } from 'https://taisho.design/core/0.16.0/taisho.core.js';
const form = document.querySelector('#nuevo-proyecto');
form.addEventListener('submit', (e) => {
e.preventDefault();
const { nombre } = form.elements;
if (!nombre.value.trim()) markInvalid(nombre, 'Falta el nombre del proyecto.');
else if (nombre.value === 'Panel de control') markInvalid(nombre, 'Ya existe un proyecto con ese nombre.');
else clearInvalid(nombre);
});
// El error se va cuando la persona corrige
form.addEventListener('input', (e) => clearInvalid(e.target));
</script>El mensaje usa el CSS de Input: si se cargan archivos por componente, se suma taisho.input.css o se usa el
completo. Con taisho generate sale solo cuando tu JS está en content.
Controlarlo desde tu código
El Core no tiene props ni estado controlado: el estado vive en el DOM, y tu código lo lee y lo escribe. Tres cosas que conviene conocer.
- El estado vive en el DOM (
aria-expanded,hidden), que es lo que el Core lee y escribe. Para abrir o cerrar un Accordion o un Collapsible desde tu código se cambia elaria-expandedde su disparador y el Core lo sigue; ese cambio no avisa conts:change, que es sólo para el gesto de la persona. - Los paneles cerrados están en el DOM, con
hidden. Están todos desde el principio: no hay nada que los cree después. - Las variantes responsive son un conjunto curado en el
archivo estático (
taisho.full.css, el del CDN): display, flex, grilla,gap, alineación y ancho; el espaciado no. Contaisho generateycontentno hay ese límite: sale cualquier utilidad con cualquier screen que se escriba. Las variantes de estado y de impresión también son un conjunto curado en el archivo estático:hover:sobre colores, subrayado y opacidad, yprint:hiddenyprint:block. El resto (focus:,disabled:,group-…:…) lo escribetaisho generatecuando se usa: ver Variantes. El modo oscuro no necesita variante: sale del tema.