Teknika ARIA WCAG 2.2
ARIA6Elementu bati aria-label bidez izena ematea testu ikusgairik ez dagoenean
Izen ofiziala W3Cn: aria-label erabiltzea objektuei etiketak emateko
Laburbilduz
aria-label atributuak izen ikusezin bat ematen dio elementu bati: ikono bat besterik ez duen botoi bati, menu bati edo orriko eremu bati. Pantaila-irakurgailuak izen hori irakurtzen du, pertsonak jakin dezan zer den. Orrian izen gisa balio duen testu ikusgairik ez dagoenean erabiltzen da.
Zergatik da garrantzitsua
Webgune askok testurik gabeko ikonoak erabiltzen dituzte: bilatzailearen lupa, saskia edo menuaren hiru marrak. Pantaila ikusten duenak marrazkiagatik ezagutzen ditu. Pantaila-irakurgailu batek (pantaila ozen irakurtzen duen programa), aldiz, «botoia» besterik ez du esaten.
Orri berean bi menu daudenean ere laguntzen du. «Menu nagusia» eta «Oineko menua» bezalako izenekin, pertsonak badaki zeinetan dagoen.
Nola egiten da
- Gehitu
aria-label, elementuak zer egiten duen edo zer den esaten duen testu labur batekin; adibidez,aria-label="Bilatu". - Erabili izena onartzen duten elementuetan: botoietan, esteketan, eremuetan,
<nav>bezalako eskualdeetan edorolebat duten elementuetan. Rolik gabeko<div>edo<span>batean ez du funtzionatzen. - Izen gisa balio duen testu ikusgai bat badago jada, hobe da
<label>edoaria-labelledbyerabiltzea. - Gogoan izan
aria-labelatributuak elementuaren berezko izena ordezten duela, hala nola irudi batenaltedo eremu baten<label>. - Elementuak
aria-labelledbyere badu, horrek irabazten du etaaria-labelez da kontuan hartzen. - Idatzi testua orriaren hizkuntzan eta «botoia» hitzik gabe: irakurgailuak iragartzen du jada mota.
Adibide praktikoa
Lineako denda baten goiburua, hiru botoirekin: bilatu, saskia eta menua. Botoi bakoitzak SVG ikono bat besterik ez du erakusten. Orrian ez dago botoi horiei izen gisa balio diezaiekeen testurik.
Horrela ez: Izenik gabeko ikono-botoiak
Ikonoak ezkutatuta daude pantaila-irakurgailuentzat, eta botoiek ez dute testurik. Horregatik, irakurgailuak hiru aldiz esaten du «botoia», bakoitzak zer egiten duen azaldu gabe. Horretaz ohartzeko, ibili barran zehar Tab teklarekin, NVDA edo VoiceOver aktibatuta duzula.

Erakustaldiak nahita dauka azaltzen den irisgarritasun-errorea.
Ikusi adibide okerraren kodea
<div class="barra">
<button type="button">
<svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><circle cx="10" cy="10" r="6" fill="none" stroke="#0B2239" stroke-width="2"/><line x1="15" y1="15" x2="21" y2="21" stroke="#0B2239" stroke-width="2"/></svg>
</button>
<button type="button">
<svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M2 4h3l3 11h11l2-8H6" fill="none" stroke="#0B2239" stroke-width="2"/><circle cx="9" cy="20" r="1.5" fill="#0B2239"/><circle cx="18" cy="20" r="1.5" fill="#0B2239"/></svg>
</button>
<button type="button">
<svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M3 6h18M3 12h18M3 18h18" stroke="#0B2239" stroke-width="2"/></svg>
</button>
</div>
<style>
.barra { display: flex; gap: .5em; }
.barra button { background: #fff; border: 1px solid #744E9A; border-radius: 4px; padding: .4em; line-height: 0; }
.barra button:focus-visible { outline: 3px solid #0B2239; outline-offset: 2px; }
</style>Horrela bai: Izena duten botoiak, aria-label-i esker
Botoi bakoitzak bere funtzioa esaten duen aria-label bat du: «Bilatu», «Saskia» eta «Menua». Ikonoak aria-hidden bidez ezkutatuta jarraitzen du. Horrela, izena aria-label-etik bakarrik ateratzen da eta ez da errepikatzen.
Probatu hemen:
Ikusi adibide zuzenaren kodea
<div class="barra">
<button type="button" aria-label="Bilatu">
<svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><circle cx="10" cy="10" r="6" fill="none" stroke="#0B2239" stroke-width="2"/><line x1="15" y1="15" x2="21" y2="21" stroke="#0B2239" stroke-width="2"/></svg>
</button>
<button type="button" aria-label="Saskia">
<svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M2 4h3l3 11h11l2-8H6" fill="none" stroke="#0B2239" stroke-width="2"/><circle cx="9" cy="20" r="1.5" fill="#0B2239"/><circle cx="18" cy="20" r="1.5" fill="#0B2239"/></svg>
</button>
<button type="button" aria-label="Menua">
<svg width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M3 6h18M3 12h18M3 18h18" stroke="#0B2239" stroke-width="2"/></svg>
</button>
</div>
<style>
.barra { display: flex; gap: .5em; }
.barra button { background: #fff; border: 1px solid #744E9A; border-radius: 4px; padding: .4em; line-height: 0; }
.barra button:focus-visible { outline: 3px solid #0B2239; outline-offset: 2px; }
</style>Nola egiaztatu
Auditorietako ohiko akatsak
- Funtziorik gabeko div edo span batean aria-label jartzea. Hor ez dago baimenduta, eta pantaila-irakurgailuek ez dute kontuan hartzen.
- Botoi edo esteka batean haren testu ikusgaiaz bestelako aria-label bat jartzea. Izenak testu ikusgaia eduki behar du (2.5.3 irizpidea).
- Ingelesezko izenak edo ikonoaren izenetik kopiatutakoak («search», «icon-cart») uztea euskarazko orri batean.
- aria-label gabeko nav eskualde batzuk izatea, edo denak izen berarekin. Horrela, ezin dira bereizi eskualdeen zerrendan.
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko ARIA6 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 objektuei laguntza-teknologiek irakur dezaketen etiketa bat ematea. aria-label atributuak objektu baten testu-etiketa ematen du, botoi batena adibidez. Pantaila-irakurgailu batek objektua aurkitzen duenean, aria-label atributuko testua irakurtzen du, eta horrela erabiltzaileak badaki zer den.
Garatzaileek kontuan izan behar dute laguntza-teknologiek aria-label ez ikusi egin dezaketela objektu berean aria-labelledby erabiltzen denean. Izenak esleitzeko hierarkiari buruzko informazio gehiago izateko, kontsultatu Accessible Name And Description Computation gomendioaren accessible name and description computation atala. Kontuan izan behar dute, halaber, aria-label erabiltzeak izena esleitzeko edozein mekanismo natibo baliogabetuko duela, hala nola irudien alt edo formularioko eremu bati for atributuaren bidez lotutako label.
Adibideak
Nabigazio-eskualdeak bereiztea
Ondorengo adibideak erakusten du nola erabil litekeen aria-label HTML dokumentu bateko bi nabigazio-eskualde (landmark) bereizteko, orri berean mota bereko bi eskualde baino gehiago daudenean eta orrian etiketa gisa erreferentzia egin dakiokeen testurik ez dagoenean.
<div role="navigation" aria-label="Primary">
<ul>
<li>...a list of links here ...</li>
</ul>
</div>
<div role="navigation" aria-label="Secondary">
<ul>
<li>...a list of links here ...</li>
</ul>
</div>
Eskualde generikoak identifikatzea
Ondorengo adibideak erakusten du nola gehi litekeen "region" eskualde (landmark) generiko bat eguraldiaren portlet bati. Orrian ez dago etiketa gisa erreferentzia egin dakiokeen testurik; beraz, aria-label bidez etiketatzen da.
<div role="region" aria-label="weather portlet">
...
</div>
Eduki matematikoari etiketa bat ematea
Jarraian, MathML-ko funtzio baten adibide bat erakusten da; math rola, etiketa egoki bat eta MathML-ko adierazpena erabiltzen ditu:
<div role="math" aria-label="6 divided by 4 equals 1.5">
<math xmlns="https://www.w3.org/1998/Math/MathML">
<mfrac>
<mn>6</mn>
<mn>4</mn>
</mfrac>
<mo>=</mo>
<mn>1.5</mn>
</math>
</div>
Probak
Prozedura
aria-label atributua duen elementu bakoitzerako.
- Aztertu testu-deskribapenak objektua zehatz etiketatzen duen, haren helburua deskribatzen duen edo informazio baliokidea ematen duen.
Espero diren emaitzak
- 1. egiaztapena egiazkoa da.
Baliabideak
- HTML Accessibility API Mappings 1.0
- WAI-ARIA Authoring Practices Guide (WAI-ARIA egileentzako jardunbideen gida)
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren ARIA6 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.