Saltar al contenido

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

html

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.

Relacionados

PagerTable

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-items
  • data-ts-label-empty
  • data-ts-label-template
  • data-ts-page
  • data-ts-page-ellipsis
  • data-ts-page-item
  • data-ts-page-next
  • data-ts-page-prev
  • data-ts-page-size
  • data-ts-pagination
  • data-ts-pagination-list
  • data-ts-total
  • data-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-templateEn el <nav>: la plantilla de la etiqueta, con {from}, {to} y {total}. Sin él, «{from}–{to} de {total}».
data-ts-label-emptyEn 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.css
  • taisho.checkbox.css
  • taisho.icon.css
  • taisho.input.css
  • taisho.kbd.css
  • taisho.select.css
  • taisho.spinner.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

  • Va en un <nav> de navegación; los botones tienen aria-label («Página 12», uno por número, también al re-dibujar la ventana) y la página actual marca aria-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.