# Paginación accesible: enlaces de página para todos

Source: https://allyway.ai/es/glossary/paginacion-accesible

La paginación accesible es un conjunto de enlaces de página (1, 2, 3, Anterior, Siguiente) que los usuarios de lector de pantalla y de teclado pueden entender y usar: los enlaces indican qué página abren, la página actual está marcada en el código y todo el bloque es una navegación con etiqueta. Los enlaces de página poco claros entran en el criterio WCAG 2.4.4 Propósito de los enlaces (en contexto), de nivel A.

La paginación accesible es la fila de números de página que aparece bajo el archivo de un blog, los resultados de una búsqueda o una lista de productos, construida para que todo el mundo sepa adónde lleva cada enlace. Una persona vidente ve «‹ 1 2 3 ›» y lo entiende. Un usuario de lector de pantalla que abre la lista de enlaces oye «1, 2, 3, enlace, enlace», a menos que la navegación por páginas tenga nombres adecuados, una página actual marcada y una etiqueta propia.

## Qué significa

El criterio [WCAG 2.4.4 Propósito de los enlaces (en contexto)](https://www.w3.org/WAI/WCAG22/Understanding/link-purpose-in-context.html) (nivel A) establece que el propósito de cada enlace puede determinarse a partir del texto del enlace por sí solo o del texto del enlace junto con su contexto determinado por software. Un «2» suelto o un icono de flecha rara vez dicen tanto por sí solos. Las correcciones salen directamente de las técnicas suficientes del W3C:

| Problema | Corrección | Técnica del W3C |
|---|---|---|
| Solo números o flechas | `aria-label="Page 2"`, «Página siguiente» | ARIA8: aria-label para el propósito del enlace |
| La flecha es un icono sin texto | Texto oculto o `aria-label` en el enlace | C7, ARIA8 |
| No se identifica la página actual | `aria-current="page"` en su enlace | ARIA26 |
| El contexto es solo visual | Los enlaces van en una lista dentro de un `nav` con etiqueta | H77: texto del enlace junto con su elemento de lista |

El `aria-label` sustituye al texto del enlace para los lectores de pantalla, así que debe empezar por el número visible («Página 2»), lo que además mantiene operativo el control por voz (véase [etiqueta en el nombre](https://allyway.ai/es/glossary/etiqueta-en-el-nombre)). Cada enlace de página es un objetivo pequeño: dé a cada uno al menos 24 por 24 píxeles CSS o un espaciado suficiente para cumplir el [tamaño del objetivo](https://allyway.ai/es/glossary/tamano-del-objetivo) (2.5.8, nivel AA).

> **Note:** > **Los puntos suspensivos no son enlaces**
> Los «…» entre la página 3 y la página 12 son decoración. Déjelos como texto normal, no como enlace, y ocúltelos con `aria-hidden="true"` si solo hacen de separador.

## Ejemplos

```html title="Ejemplo"
<nav aria-label="Pagination">
  <ul>
    <li><a href="?page=1" aria-label="Previous page">‹</a></li>
    <li><a href="?page=1" aria-label="Page 1">1</a></li>
    <li><a href="?page=2" aria-label="Page 2" aria-current="page">2</a></li>
    <li><a href="?page=3" aria-label="Page 3">3</a></li>
    <li><span aria-hidden="true">…</span></li>
    <li><a href="?page=12" aria-label="Page 12">12</a></li>
    <li><a href="?page=3" aria-label="Next page">›</a></li>
  </ul>
</nav>
```

El `<nav>` con etiqueta se convierte en una de las [regiones ARIA](https://allyway.ai/es/glossary/regiones-aria) de la página, de modo que los usuarios de lector de pantalla pueden saltar directamente a él. Cada enlace recibe un [nombre accesible](https://allyway.ai/es/glossary/nombre-accesible) que indica qué página abre, y `aria-current="page"` anuncia la página 2 como la actual. Haga que el aspecto de la página actual se distinga también por algo más que el color.

**Do:** Qué hacer

Utilice enlaces reales con `href` para que cada página tenga su propia URL, ponga etiqueta al `nav`, dé a los enlaces de números y de flechas nombres como «Página 3» y «Página siguiente», marque la página actual con `aria-current` y lleve el foco al principio de los nuevos resultados después de cargarlos.

**Don't:** Qué evitar

Construir los números de página con elementos `div` y controladores de clic, dejar las flechas con iconos sin nombre, indicar la página actual solo con el color, convertir los «…» en un enlace, o recargar los resultados sin avisar a los usuarios de lector de pantalla de que algo ha cambiado.

## Cómo comprobar la paginación accesible



## Preguntas frecuentes

Q: ¿Un enlace que solo dice «2» incumple las WCAG?
A: Puede incumplirlas. El criterio WCAG 2.4.4 solo da por válido el contexto circundante si está determinado por software, por ejemplo el elemento de lista o la frase que lo contiene. Un número suelto en una fila de números normalmente no basta, así que dele un nombre como «Página 2» con `aria-label` o con texto oculto.

Q: ¿Cómo marco la página actual en la paginación?
A: Añada `aria-current="page"` al enlace de la página actual (técnica ARIA26 del W3C). Los lectores de pantalla la anunciarán entonces como la página actual. Mantenga también una diferencia visible, como un borde o el texto en negrita, y no solo un color.

Q: ¿Deben las flechas decir «Anterior» y «Siguiente»?
A: Sí: las flechas que son solo un icono necesitan un nombre. «Página anterior» y «Página siguiente» son más claros que «Anterior» y «Siguiente» cuando la lista de enlaces se lee fuera de contexto.

Q: ¿Es «Cargar más» mejor que la paginación para la accesibilidad?
A: Ninguna de las dos es mejor por defecto. Un botón «Cargar más» debe ser un botón real, indicar cuántos elementos nuevos han aparecido y mantener el foco en un lugar razonable. Las páginas numeradas dan a cada página de resultados su propia URL, lo que ayuda a las personas a volver al punto en el que estaban.

Q: ¿Qué criterios WCAG se aplican a la paginación?
A: Principalmente el 2.4.4 Propósito de los enlaces (en contexto), el 2.1.1 Teclado, el 4.1.2 para los nombres y el 2.5.8 Tamaño del objetivo (mínimo). Todos forman parte del nivel AA de las [WCAG 2.2](https://allyway.ai/es/regulations/wcag-2-2).
