Table
betaTabla 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 |
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 |
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
gridystack. - No conviene poner veinte columnas: si no entran, se prioriza y el detalle pasa a otra vista.
Relacionados
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-celldata-ts-keydata-ts-rowdata-ts-sort-valuedata-ts-tabledata-ts-table-bodydata-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:change | Sale 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-dir | En 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-value | En 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³). |
lang | Sin 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.csstaisho.empty-state.csstaisho.icon.csstaisho.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.
<div class="ts table-wrapper" id="proyectos" data-ts-table data-ts-sort-key="proyecto" data-ts-sort-dir="asc">
<table class="ts table">
<thead class="ts table-header">
<tr>
<th class="ts table-th is-sortable is-sorted" data-ts-th data-ts-key="proyecto" tabindex="0" aria-sort="ascending">
<span class="ts table-th-content">Proyecto</span>
</th>
<th class="ts table-th is-sortable" data-ts-th data-ts-key="estado" tabindex="0" aria-sort="none">
<span class="ts table-th-content">Estado</span>
</th>
</tr>
</thead>
<tbody class="ts table-body" data-ts-table-body>
<!-- Las filas de la página actual, como las manda tu servidor -->
</tbody>
</table>
</div>
<nav class="ts pagination size-md" id="proyectos-paginas" aria-label="Páginas de proyectos" data-ts-pagination data-ts-total="6" data-ts-page="1">
<!-- Los botones de Pagination, como en su página -->
</nav>
<script>
const tabla = document.querySelector('#proyectos');
const paginador = document.querySelector('#proyectos-paginas');
const cuerpo = tabla.querySelector('[data-ts-table-body]');
const consulta = { orden: 'proyecto', dir: 'asc', pagina: 1 };
async function cargar() {
const respuesta = await fetch(`/proyectos/filas?${new URLSearchParams(consulta)}`);
cuerpo.innerHTML = await respuesta.text();
}
tabla.addEventListener('ts:change', (e) => {
e.preventDefault(); // Las filas las ordena el servidor
consulta.orden = e.detail.key;
consulta.dir = e.detail.direction;
consulta.pagina = 1;
paginador.setAttribute('data-ts-page', '1'); // El paginador se repinta solo
cargar();
});
paginador.addEventListener('ts:change', (e) => {
consulta.pagina = e.detail.page;
cargar();
});
</script>Accesibilidad
Implementa el patrón Table de la WAI-ARIA APG.
- Estructura semántica
<table>/<th>/<td>; el orden se refleja enaria-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/Espacio | Sobre 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.