Addaw, joan hasierara Egin dohaintza

Teknika ARIA WCAG 2.2

ARIA13Orriko eskualdeei izena ematea aria-labelledby bidez

Izen ofiziala W3Cn: aria-labelledby erabiltzea eskualdeei (landmarks) izena emateko

Versión en castellano · Versió en català

Laburbilduz

Orriko eskualde askok, hala nola menu batek edo alboko barra batek, badute izenburu ikusgai bat. aria-labelledby erabiliz, izenburu hori eskualdearen izen bihurtzen da. Horrela, pantaila-irakurgailuak, adibidez, «Kultur agenda, osagarria» iragartzen du, eta pertsonak gune bakoitza bereizten du.

Zergatik da garrantzitsua

Pantaila-irakurgailuek (pantaila ozen irakurtzen duten programak) orriko eskualdeen zerrenda bat erakusten dute. Izenik gabeko hiru «nabigazio» gune badaude, pertsonak ez daki zein den menu nagusia, zein atalekoa eta zein orri-oinekoa.

Ikusten den izenburua erabiltzean, guztiek izen bera jasotzen dute. Gainera, norbaitek izenburua aldatzen badu, eskualdearen izena ere harekin batera aldatzen da.

Nola egiten da

  1. Aurkitu izenburu ikusgaia duten eskualdeak (normalean, izenburu-elementu bat).
  2. Eman izenburu horri id bakar bat; adibidez, id="tit-agenda".
  3. Gehitu eskualdeari aria-labelledby="tit-agenda". Balio du <nav>, <aside>, <section> eta <form> elementuetan, baita eskualde-role bat duten elementuetan ere.
  4. <section> bat izena duenean bakarrik agertzen da eskualde gisa. Atributu honek ematen dio izen hori.
  5. Erabili izenburu laburrak eta ez errepikatu eskualde mota: «Kultur agenda», ez «Kultur agendaren eskualdea».
  6. Izenburu ikusgairik ez badago, erabili aria-label (ARIA6 teknika).

Nola egiaztatu

  1. Bilatu kodean aria-labelledby duten eskualdeak.
  2. Egiaztatu adierazitako id-a orrian badagoela.
  3. Irakurri erreferentziatutako testua eta berretsi gune hori ondo deskribatzen duela.
  4. Ireki pantaila-irakurgailuaren eskualdeen zerrenda (NVDAn, Insert + F7; VoiceOverren, errotorea). Eskualde bakoitzak bere izenarekin agertu behar du.

Adibidea

Alboko barra, izena bere izenburu ikusgaitik hartzen duena.

<aside aria-labelledby="tit-agenda">
  <h2 id="tit-agenda">Kultur agenda</h2>
  <ul>
    <li><a href="/agenda/teatro">Antzerkia Plaza Nagusian</a></li>
    <li><a href="/agenda/concierto">Udal musika-bandaren kontzertua</a></li>
  </ul>
</aside>
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko ARIA13 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.

Aplikagarritasuna

Accessible Rich Internet Applications (WAI-ARIA) onartzen duten teknologiak.

Deskribapena

Teknika honen helburua da orri bateko eskualdeei laguntza-teknologiek irakur ditzaketen izenak ematea. aria-labelledby atributuak eskualde gisa (region edo landmark) markatutako orri-atal bat orrian dagoen eta atal hori etiketatzen duen testu batekin lotzeko modua eskaintzen du.

Eskualde-funtzioek (edo «eskualdeek», landmarks) orri bateko atalak identifikatzen dituzte programatikoki. Eskualdeek laguntza-teknologiak erabiltzen dituztenei laguntzen diete orri batean orientatzen eta haren atal desberdinetara erraz mugitzen.

aria-describedby atributuak bezala, aria-labelledby atributuak hainbat id onar ditzake orriko beste gune batzuei erreferentzia egiteko, zuriunez bereizitako zerrenda baten bidez. Multzo horiek definitzeko, id-etara mugatuta dago hura ere.

Adibideak

Eskualde bat orriko testuarekin identifikatzea

Jarraian, complementary eskualde batean erabilitako aria-labelledby atributuaren adibide bat erakusten da. Izenburua dagokion dokumentuaren gunea aria-labelledby propietatearekin marka daiteke, eta haren balioa izenburuaren id-a da.

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

application motako eskualdeak identifikatzea

Ondorengo kode-zatia testu estatikoa duten application motako eskualdeei dagokie. application motako eskualde bat baduzu eta testu deskribatzaile estatiko bat baduzu, sartu application eskualdean aria-describedby erreferentzia bat aplikazioa testu estatikoarekin lotzeko, hemen erakusten den bezala:

<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>

Probak

Prozedura

  1. Aztertu role=region atributua edo eskualde-funtzio (landmark) bat duen eta aria-labelledby atributua ere duen elementu bakoitza.
  2. Egiaztatu aria-labelledby atributuaren balioa orriko elementu baten id-a dela.
  3. Egiaztatu id hori duen elementuaren testuak orriko atala zehatz etiketatzen duela.

Espero diren emaitzak

  • 2. eta 3. egiaztapenak egiazkoak dira.

Baliabideak

Nola egiaztatzen dugun ADDAWn

ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.

Eskatu auditoria bat

W3Cren ARIA13 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.