Saltar al contenido

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
Nada16Renderiza y queda correcto sin una línea de JS.Badge, Button, Grid, Separator, Skeleton
Lo hace el navegador2Monta sobre una primitiva nativa: <dialog>, popover, <input>.Modal, Drawer
Comportamiento29El Core alterna un atributo, el aria y una clase.Tabs, Accordion, Pagination, Tooltip
Interacción completa9Foco, 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.

html
<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 panelAccordion, Collapsibledata-ts-accordion
PestañasTabsdata-ts-tabs
Grupo tipo radioSegmentedControldata-ts-segmented
Valor o tramo en un rangoSliderdata-ts-slider
DescartarBanner, Tagdata-ts-dismissible
Mostrar u ocultar un bloqueBreadcrumbs, NavBardata-ts-toggle
Copiar al portapapelesCodedata-ts-copy
Brillo que sigue al punteroCarddata-ts-spotlight
Sección activa al hacer scrollTocdata-ts-scrollspy
Respaldo si la imagen fallaAvatardata-ts-avatar
Sumar y restarNumberInputdata-ts-number
Arrastrar archivosFileUploaddata-ts-file-upload
Flotante ancladoTooltipdata-ts-tooltip-root
Flotante con la Popover APIPopoverpopovertarget + popover
PaginarPaginationdata-ts-pagination
Lista de opcionesSelect, Comboboxdata-ts-listbox
Buscador de accionesCommandPalettedata-ts-command-palette
MenúMenu, ContextMenudata-ts-menu
CalendarioDatePickerdata-ts-date-picker
Ordenar y virtualizarTabledata-ts-table
Colapsar navegaciónSidebardata-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.

js
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
});
El Core usa delegación de eventos: un puñado de listeners cubren todo el documento. El HTML que aparezca después —traído por 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.

html

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.

html

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 el aria-expanded de su disparador y el Core lo sigue; ese cambio no avisa con ts: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. Con taisho generate y content no 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, y print:hidden y print:block. El resto (focus:, disabled:, group-…:…) lo escribe taisho generate cuando se usa: ver Variantes. El modo oscuro no necesita variante: sale del tema.