Addaw, anar a la pàgina d'inici Donar

Tècnica ARIA WCAG 2.2

ARIA13Donar nom a les regions de la pàgina amb aria-labelledby

Nom oficial al W3C: Utilitzar aria-labelledby per anomenar regions (landmarks)

Versión en castellano

En poques paraules

Moltes regions de la pàgina, com ara un menú o una barra lateral, ja tenen un títol visible. Amb aria-labelledby, aquest títol es converteix en el nom de la regió. Així el lector de pantalla anuncia, per exemple, «Agenda cultural, complementari», i la persona distingeix cada zona.

Per què és important

Els lectors de pantalla (programes que llegeixen en veu alta la pantalla) mostren una llista de les regions de la pàgina. Si hi ha tres zones «navegació» sense nom, la persona no sap quin és el menú principal, quin el de la secció i quin el del peu.

En utilitzar el títol que ja es veu, tothom rep el mateix nom. A més, si algú canvia el títol, el nom de la regió canvia amb ell.

Com es fa

  1. Localitzeu les regions que tenen un títol visible, normalment un encapçalament.
  2. Doneu a aquest títol un id únic, per exemple id="tit-agenda".
  3. Afegiu a la regió aria-labelledby="tit-agenda". Serveix en <nav>, <aside>, <section>, <form> i en elements amb un role de regió.
  4. Una <section> només apareix com a regió quan té nom. Aquest atribut l'hi dona.
  5. Utilitzeu títols breus i no repetiu el tipus de regió: «Agenda cultural», no «Regió d'agenda cultural».
  6. Si no hi ha títol visible, utilitzeu aria-label (tècnica ARIA6).

Com comprovar-ho

  1. Cerqueu al codi les regions amb aria-labelledby.
  2. Comproveu que l'id indicat existeix a la pàgina.
  3. Llegiu el text a què apunta i confirmeu que descriu bé aquesta zona.
  4. Obriu la llista de regions del lector de pantalla (a NVDA, Insert + F7; a VoiceOver, el rotor). Cada regió hi ha d'aparèixer amb el seu nom.

Exemple

Barra lateral el nom de la qual surt del seu encapçalament visible.

<aside aria-labelledby="tit-agenda">
  <h2 id="tit-agenda">Agenda cultural</h2>
  <ul>
    <li><a href="/agenda/teatro">Teatre a la plaça Major</a></li>
    <li><a href="/agenda/concierto">Concert de la banda municipal</a></li>
  </ul>
</aside>
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica ARIA13 de Techniques for WCAG 2.2, del W3C. Pot contenir errors. L'únic document oficial i normatiu és la versió original en anglès, publicada al lloc web del W3C.

Aplicabilitat

Tecnologies que admeten Accessible Rich Internet Applications (WAI-ARIA).

Descripció

L'objectiu d'aquesta tècnica és proporcionar noms per a les regions d'una pàgina que les tecnologies de suport puguin llegir. L'atribut aria-labelledby ofereix una manera d'associar una secció de la pàgina marcada com a regió (region o landmark) amb un text present a la pàgina que l'etiqueta.

Les funcions de regió (o «regions», landmarks) identifiquen per programari les seccions d'una pàgina. Les regions ajuden qui utilitza tecnologies de suport a orientar-se en una pàgina i a desplaçar-se amb facilitat a les diferents seccions.

Igual que aria-describedby, aria-labelledby pot acceptar diversos id per apuntar a altres zones de la pàgina mitjançant una llista separada per espais. També està limitat a id per definir aquests conjunts.

Exemples

Identificar una regió amb text de la pàgina

A continuació es mostra un exemple d'aria-labelledby utilitzat en una regió complementary. La zona del document a la qual pertany l'encapçalament es pot marcar amb la propietat aria-labelledby, el valor de la qual és l'id de l'encapçalament.

<div role="complementary" aria-labelledby="hdr1">
  <h1 id="hdr1">Top News Stories</h1>
  ...
</div>

Identificació de regions de tipus application

El fragment de codi següent correspon a regions de tipus application amb prosa estàtica. Si teniu una regió de tipus application i disposeu d'un text descriptiu estàtic, incloeu a la regió application una referència aria-describedby per associar l'aplicació amb el text estàtic, com es mostra aquí:

<div role="application" aria-labelledby="p123" aria-describedby="info">
   <h1 id="p123">Calendar<h1>
   <p id="info">This calendar shows the game schedule for the Boston Red Sox.</p>
   <div role="grid">
    ...
   </div>
</div>

Proves

Procediment

  1. Examinar cada element amb l'atribut role=region o amb una funció de regió (landmark) en què també hi hagi un atribut aria-labelledby.
  2. Comprovar que el valor de l'atribut aria-labelledby és l'id d'un element de la pàgina.
  3. Comprovar que el text de l'element amb aquest id etiqueta amb precisió la secció de la pàgina.

Resultats esperats

  • Les comprovacions núm. 2 i núm. 3 són certes.

Recursos

Com ho comprovem a ADDAW

En cada auditoria d'ADDAW revisem aquesta tècnica pàgina per pàgina i us lliurem els errors amb captures i la manera de corregir-los.

Sol·licitar una auditoria

Basat en la tècnica ARIA13 del W3C (WCAG 2.2). Explicació i exemples: ADDAW. Traducció no oficial del text del W3C © W3C, llicència de documents del W3C. Heu vist un error? Escriviu-nos.