Saltar al contenido

Table

beta

Tabla de datos con ordenamiento, selección de filas, estados de carga y vacío, y celdas personalizadas. Puede virtualizar para listas largas.

Contenido · 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.

Tabla ordenable por columna

Nombre Plan Edad
Beto Pro 30
Ana Free 9
Cami Pro 41
html

Números con formato

Proyecto Solicitudes por mes
Panel de control 18.500
API de pagos 126.000
Sitio marketing 4.100
App móvil 920
html

Cuándo usarlo

  • Los datos son homogéneos y se comparan de a filas: mismas columnas para todos.
  • Hace falta ordenar, seleccionar o escanear muchos registros.
  • La lista es larga y conviene virtualizarla en vez de paginarla.

Cuándo no

  • Cada ítem es distinto y se lee como una unidad → card.
  • El caso es maquetar una grilla de layout, no datos → grid.
  • No hay datos que mostrar: ese caso es un empty-state.

Cómo usarlo

  • Se definen los estados de carga y vacío: una tabla en blanco no explica nada.
  • Los números se alinean a la derecha y el ancho de columna se mantiene estable al ordenar.

Cómo no usarlo

  • No se usa para maquetar: para eso están grid y stack.
  • No conviene poner veinte columnas: si no entran, se prioriza y el detalle pasa a otra vista.

TaishoDS Core

Necesita el JS del Core: maneja foco, teclado y estado.

Ordena y virtualiza las filas por ventana.

El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.

  • data-ts-cell
  • data-ts-key
  • data-ts-row
  • data-ts-sort-value
  • data-ts-table
  • data-ts-table-body
  • data-ts-th

Qué hace: Ordenamiento y virtualización (mide el viewport, calcula la ventana visible y recicla filas). El orden parte siempre del orden original de las filas, así que al cambiar de columna los empates salen en el orden inicial y no en el del último orden. El orden es local: mueve sólo las filas que están en el DOM, así que en una tabla paginada no alcanza a las otras páginas.

Atributo Qué hace
ts:changeSale al activar un encabezado ordenable, antes de mover las filas, con detail.component ("table"), detail.key (el data-ts-key de la columna) y detail.direction ("asc" o "desc"). Es cancelable: si se frena, las filas quedan como están, pero la tabla registra igual la columna y la dirección (data-ts-sort-key, data-ts-sort-dir y aria-sort), así el próximo clic calcula bien la dirección.
data-ts-sort-key, data-ts-sort-dirEn la raíz: la columna y la dirección del orden actual. Si la tabla ya llega ordenada, se escriben en el HTML, con aria-sort e is-sorted en su <th>: el primer clic en esa columna invierte el orden.
data-ts-sort-valueEn la <td>: el valor por el que se ordena la fila, en lugar del texto de la celda. Se lee como número si lo es (con punto decimal y sin separadores: 1850), si no como texto. Sirve cuando lo que se ve no es lo que se compara: un número con formato (1.850, ١٬٨٥٠), una moneda, una fecha (2026-11-07) o una unidad (410 hm³).
langSin data-ts-sort-value, el texto de la celda se lee como número en el idioma del lang más cercano: en es «1.850» vale 1850 y «1,5» vale 1,5; en en «1,850» vale 1850; en ar «١٬٨٥٠» vale 1850. Sólo se reconoce el entero, con o sin miles en grupos de tres, y el decimal del idioma. Lo demás (monedas, unidades) se ordena como texto.

Sin build, desde el CDN: taisho.table.css, además de taisho.base.css. También se carga:

  • taisho.checkbox.css
  • taisho.empty-state.css
  • taisho.icon.css
  • taisho.skeleton.css

Para el funcionamiento general del Core, ver Comportamiento.

Ordenar en el servidor

Si la tabla muestra una página de un listado más largo, se cancela ts:change y se piden al servidor las filas ya ordenadas. El encabezado marca el orden nuevo apenas se hace clic: si el pedido falla, se avisa del error y se ofrece reintentar.

html

Accesibilidad

Implementa el patrón Table de la WAI-ARIA APG.

  • Estructura semántica <table>/<th>/<td>; el orden se refleja en aria-sort. Al ordenar por otra columna los empates conservan el orden original de las filas, no el del último orden: el orden que anuncia un lector de pantalla es predecible.
  • El wrapper tiene overflow-x-auto, así que en pantallas chicas la tabla scrollea sin romper el layout.

Teclado

Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).

Tecla Qué hace
Enter/EspacioSobre una cabecera ordenable, ordena por esa columna (ascendente, descendente). La cabecera es un <th tabindex="0"> con aria-sort, sin <button> dentro.

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 Mapa de teclas documentado arriba, contrastado contra el componente.
  • 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.