Pagination
Navegación entre páginas de un conjunto grande de datos. Dibuja el rango de páginas a partir de data-ts-total (cuántas son), colapsa el medio en “…” y puede mostrar el selector de tamaño de página (data-ts-page-size-control).
Navegación · 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.
Lista larga de proyectos, 20 páginas
Cuándo usarlo
- Hay muchos registros y hace falta saber cuántos son y en cuál página se está.
- El usuario tiene que poder volver a una página concreta.
- Conviene dejarlo elegir cuántos ítems ver por página.
Cuándo no
- El contenido tiene orden de lectura y no es un conjunto de datos →
pager. - La lista es corta y entra entera: no se parte.
- Es una tabla que ya resuelve su propio recorrido →
table.
Cómo usarlo
- Se muestra el total: es lo que le dice al usuario cuánto falta.
- La página se mantiene en la URL, para que se pueda compartir y volver.
Cómo no usarlo
- No se pagina de a cinco ítems: obliga a hacer clic todo el tiempo.
- No se mezclan paginado y scroll infinito en la misma lista.
TaishoDS Core
Necesita el JS del Core: lo engancha por atributos data-ts-*.
La página actual la lleva el Core: como HTML estático no cambia de página.
El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.
data-ts-itemsdata-ts-label-emptydata-ts-label-templatedata-ts-pagedata-ts-page-ellipsisdata-ts-page-itemdata-ts-page-nextdata-ts-page-prevdata-ts-page-sizedata-ts-paginationdata-ts-pagination-listdata-ts-totaldata-ts-value
Qué hace: Marca la página activa, redibuja la ventana de números y emite el cambio. Incluye los botones de los extremos (data-ts-page-first y data-ts-page-last), la etiqueta «11–20 de 200» (data-ts-page-label) y el selector de ítems por página (data-ts-page-size-control). Cada botón lleva su nombre accesible.
| Atributo | Qué hace |
|---|---|
data-ts-label-template | En el <nav>: la plantilla de la etiqueta, con {from}, {to} y {total}. Sin él, «{from}–{to} de {total}». |
data-ts-label-empty | En el <nav>: la etiqueta cuando no hay ítems. Sin él, «0 resultados». |
Sin build, desde el CDN: taisho.pagination.css, además de taisho.base.css. También se carga:
taisho.button.csstaisho.checkbox.csstaisho.icon.csstaisho.input.csstaisho.kbd.csstaisho.select.csstaisho.spinner.css
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
- Va en un
<nav>de navegación; los botones tienenaria-label(«Página 12», uno por número, también al re-dibujar la ventana) y la página actual marcaaria-current. - Los botones de prev/next se deshabilitan en los extremos.
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.