# Región de referencia

## Qué es

Una región de referencia, también llamada landmark, landmark region o ARIA landmark, es una parte de una página web cuyo propósito identifica el marcado, como la cabecera del sitio, el contenido principal, la navegación o el pie, para que las tecnologías de asistencia puedan enumerar esas partes y desplazarse directamente a cualquiera de ellas. Una página suele tener varias regiones de referencia; juntas describen su disposición a quien nunca la ve.

WAI-ARIA 1.2 define ocho roles de región de referencia: `banner`, `navigation`, `main`, `complementary`, `contentinfo`, `search`, `form` y `region`. Un noveno, el propio `landmark`, es el padre abstracto en el modelo de roles de la especificación, que indica a los autores que no lo utilicen. La mayoría de las páginas no necesita el atributo `role` para obtener los demás, porque los elementos HTML ya los aportan:

- `main` es la región de referencia `main`, y `nav` es una región `navigation`.
- `header` y `footer` solo se convierten en `banner` y `contentinfo` cuando pertenecen a la página completa. Dentro de un `article`, una `section` o `main`, son estructura ordinaria de página y no regiones de referencia.
- `aside` es `complementary` en el nivel superior de la página o dentro de `main`. En otros contenidos de seccionamiento solo cuenta si tiene un nombre.
- `section` solo se convierte en una región de referencia `region` cuando tiene un nombre accesible, procedente de `aria-label` o de un encabezado referenciado con `aria-labelledby`. Una `section` sin nombre es solo un grupo.
- `form` corresponde al rol `form` y la especificación exige que los autores lo etiqueten. El elemento más reciente `search` corresponde a `search`.

La especificación pide a las tecnologías de asistencia que permitan llegar rápidamente a estas regiones, y los lectores de pantalla lo hacen. En NVDA, `D` pasa a la siguiente región de referencia y la lista de elementos las muestra todas a la vez; el rotor de VoiceOver tiene su propia lista. Quien llega a una página puede abrirla, oír que hay una cabecera, una navegación, una región principal y un pie, y conocer la estructura de la página antes de leer una palabra.

## Por qué importa

La decisión que hay detrás de las regiones de referencia es si todas las partes de una página están en algún lugar que quien escucha pueda identificar y alcanzar. En una página típica, la mayoría del contenido se repite: la cabecera, el menú, el pie y a menudo una barra lateral son iguales en todas las páginas del sitio, y la parte nueva está en algún lugar intermedio. La mirada de un visitante que ve la página va directamente a ella. Sin regiones de referencia, quien usa un lector de pantalla debe escuchar la misma cabecera y el mismo menú en cada página, o adivinar cuántos encabezados saltarse.

La técnica de WCAG para las regiones de referencia, ARIA11, figura como una forma suficiente de satisfacer tres criterios de conformidad. Uno pide una manera de saltar bloques repetidos entre páginas; otro, que la estructura que un lector vidente deduce de la disposición también esté disponible para el software. Cumplirlos así cuesta poco cuando la página ya se construye con `header`, `nav`, `main` y `footer`: la semántica viene con el elemento y no hay nada adicional que mantener. Añadir regiones de referencia a una estructura de elementos `div` anidados cuesta más, pero el trabajo es sobre todo mecánico.

Conviene conocer dos límites. El primero es que la especificación deja la navegación por regiones de referencia como opcional para los navegadores habituales, de modo que quien utiliza el teclado sin lector de pantalla normalmente no obtiene nada de ellas por sí solas y un enlace visible para saltar contenido sigue teniendo sentido. El segundo es que más regiones no facilitan necesariamente el uso de una página. Cada una añade una entrada a una lista que alguien debe escuchar; una página donde cada bloque es una región con nombre se lee como un índice de cincuenta líneas. La especificación reserva `region` para contenido lo bastante importante para figurar en un resumen de la página y pide utilizarlo solo cuando ninguno de los demás roles describe su propósito.

## Cómo se aplica en la práctica

La marca de todas las páginas interiores estaba fuera de cualquier región de referencia y nada en pantalla lo delataba, algo típico de un defecto que solo la estructura puede mostrar. Se descubrió durante el [trabajo orientado a cumplir WCAG 2.2 nivel AA en todo el sitio](/es/portfolio/a-site-that-meets-the-accessibility-standard/). La automatización ejecuta un motor de reglas de accesibilidad con las reglas de buenas prácticas activadas, no solo las de conformidad, una diferencia de treinta reglas, y una de las adicionales falló en cuanto se activó.

Las comprobaciones explican cómo pasó inadvertido. Entre [once defectos que el navegador había dado por sanos](/es/portfolio/the-accessibility-faults-your-checker-misses/), dos estaban en las propias comprobaciones, no en las páginas; uno era que el motor solo ejecutaba setenta de sus ciento cinco reglas. La regla que habría detectado la región de referencia ausente no estaba en el conjunto. La lección es breve: un conjunto de reglas que no contiene una regla no puede hacerla cumplir.

Fuera del sitio principal, la página de entrada a la [forja Git propia de la empresa](/es/portfolio/your-code-on-your-own-hardware/) había sido una copia del diseño del sitio principal mantenida a mano, y todas las diferencias detectadas entre ambos resultaron ser accidentes, no decisiones. Una de las cinco era que ninguna página tenía una región principal ni un encabezado de primer nivel; ninguna de las cinco se veía en una captura. Se eliminó la copia y la página de entrada se construye ahora con las plantillas del propio sitio principal, por lo que hereda la misma estructura en lugar de imitarla.

## Dónde surgen los problemas

Los errores de las regiones de referencia pasan inadvertidos en pantalla y se oyen claramente en un lector de pantalla. Estos son los habituales.

**El contenido queda fuera de todas las regiones de referencia.** Un logotipo, un aviso de cookies o un selector de idioma se coloca antes de `header` o después de `footer`, y quien se mueve por regiones lo pasa por alto. La regla `region` de axe informa de todo contenido no incluido en una región de referencia, pero está etiquetada como buena práctica, no como fallo de WCAG; una ejecución limitada a las etiquetas WCAG nunca la ejecuta. Active las reglas de buenas prácticas y mueva el elemento fuera de lugar a la región que le corresponda.

**El mismo rol aparece dos veces con el mismo nombre.** Dos elementos `nav`, uno en la cabecera y otro en el pie, se anuncian como «navegación», y quien escucha debe adivinar cuál es cuál. Dé a cada uno una etiqueta breve y distinta mediante `aria-label` o `aria-labelledby`, y deje el rol fuera de la etiqueta: una navegación etiquetada «navegación del sitio» se lee como «navegación del sitio navegación».

**Aparece una segunda región principal o cabecera.** Se asigna a un `div` el atributo `role="main"` o `role="banner"` para dar importancia a un componente, o una plantilla envuelve una página interior en un `main` propio; la página anuncia ahora dos instancias de un rol que debería tener una sola. La especificación pide como máximo un `banner`, un `main` y un `contentinfo` por página, y axe tiene una regla para cada uno. Revise la lista de regiones de referencia después de cada cambio de disposición y deje que los elementos nativos aporten los roles siempre que puedan.

**Cada bloque se convierte en una región.** Una biblioteca de componentes asigna a cada `section` un `aria-label` por defecto y la lista de regiones se llena de títulos de tarjetas. Dé nombre a una `section` solo cuando un lector quiera saltar a ella desde cualquier lugar de la página.

Una página con la estructura del esquema siguiente da cinco paradas a quien escucha, todas distintas:

```html
<header><!-- logo, search --></header>
<nav aria-label="Site"><!-- menu --></nav>
<main>
    <h1>Prices</h1>
    <section aria-labelledby="hosting">
        <h2 id="hosting">Hosting</h2>
    </section>
</main>
<footer><!-- contact, legal --></footer>
```

## Lecturas adicionales

- [WAI-ARIA 1.2: roles de región de referencia](https://www.w3.org/TR/wai-aria-1.2/#landmark_roles) — los ocho roles, la función de cada uno y cuáles deben llevar etiqueta.
- [Regiones de referencia](https://www.w3.org/WAI/ARIA/apg/practices/landmark-regions/) — la guía de autoría del W3C sobre elección de roles, etiquetado de regiones repetidas y mantenimiento de todo el contenido dentro de una región.
- [Correspondencias de HTML con las API de accesibilidad 1.0](https://www.w3.org/TR/html-aam-1.0/) — qué elementos HTML se convierten en qué roles, incluido cuándo `header`, `footer`, `aside` y `section` cuentan como regiones de referencia.
- [ARIA11: utilizar regiones de referencia ARIA para identificar regiones de una página](https://www.w3.org/WAI/WCAG22/Techniques/aria/ARIA11) — la técnica de WCAG, con su procedimiento de prueba y los criterios de conformidad que satisface.

<https://engineer.company/es/glossary/landmark/>
