9. ikasgaia (10 guztira) · 11 min irakurtzeko · Berrikuspen-data: 26/10/2026
ARIArekin egiten diren ohiko akatsak eta nola hauteman
Ikasgai ireki bat irakurtzen ari zara. Matrikulatu doan testak eta ariketak egiteko, zure aurrerapena gordetzeko eta ziurtagiria lortzeko.
Ehunka webgune auditatu ondoren, ARIAren akats berberak errepikatzen dira beti. Ez dira akats exotikoak: egiten duten promesa ulertu gabe kopiatutako kode zatiak dira, «badaezpada» jarritako atributuak eta eguneratzea ahazten diren egoerak. Ikasgai honek akats horiek katalogatzen ditu, kasu bakoitzean erabiltzaileak zer entzuten duen azaltzen du, eta produkziora iritsi aurretik hautemateko metodoa ematen du.
Akats errepikatuenak
1. Rol erredundanteak edo baliogabeak
<button role="button">…</button>
<nav role="navigation">…</nav>
<div role="boton">…</div>
<span role="text">…</span>Lehenengo biak kaltegabeak dira, baina alferrikakoak. Hirugarrenak existitzen ez den rol bat erabiltzen du (rolak ingelesez daude, eta espezifikazioan bezala idazten dira, zehatz-mehatz); beraz, nabigatzaileak ez du kontuan hartzen. Laugarrenak ARIA 1.2-ren parte ez den eta euskarri inkoherentea duen rol bat erabiltzen du. Rol baliogabe bat izatea rolik ez izatearen baliokidea da.
2. Rola portaerarik gabe
<div role="button" onclick="abrir()">Ireki panela</div>Irakurgailuak «Ireki panela, botoia» iragartzen du. Pertsona Sartu sakatzen saiatzen da: ez da ezer gertatzen, elementuak ez baitu fokua jasotzen ere. 1. eta 3. arauak aldi berean urratzen dira. Zuzenketa <button> erabiltzea da; ezinezkoa bada, tabindex="0" eta Sartu eta Zuriune-barra teklen kudeatzailea gehitzea.
3. Eguneratzen ez diren egoerak
HTMLn idatzitako eta JavaScriptek inoiz aldatzen ez duen aria-expanded="false"; aria-selected="true" fitxa guztietan aldi berean; klikari jarraitzen ez dion aria-checked. Pertsonak «tolestuta» entzuten du, panela irekita dagoela. Egin CSSa atributuaren mende egon dadin, ahanztura horiek pantailan ere ikus daitezen.
4. aria-hidden elementu fokagarrietan edo eduki ikusgai garrantzitsuan
<a href="/perfil" aria-hidden="true">Nire profila</a>
<main aria-hidden="true">…</main> <!-- ahaztua leiho modal bat itxi ondoren -->Lehenengo kasuak Tab geldialdi mutu bat sortzen du. Bigarrena eskuz egindako leiho modalen klasiko bat da: irekitzean orriaren gainerakoa ezkutatzen da, eta ixtean inork ez du leheneratzen; ondorioz, eduki nagusia betiko desagertzen da irakurgailuarentzat. Erabili inert edo <dialog>, eta egiaztatu egoera itxi ondoren.
5. Erreferentzia hautsiak
aria-labelledby="titulo", id="titulo" duen elementurik ez dagoenean, edo birfaktorizazio batean aldatu zen id batera seinalatzen duen aria-controls. Izena hutsik geratzen da edo erlazioa galtzen da, eta inor ez da konturatzen, bisualki ez baita ezer aldatzen. Osagai berrerabilgarriak dituzten aplikazioetan, gainera, id finkoak bikoiztu egiten dira osagaia bi aldiz agertzen denean orrian; sortu identifikatzaile bakarrak instantzia bakoitzeko.
6. Onartzen ez dituzten elementuetako atributuak
<div aria-label="Albisteak">…</div>
<p aria-expanded="true">…</p>
<input type="text" aria-checked="true">ARIAk definitzen du rol bakoitzak zer egoera eta propietate onartzen dituen. aria-expanded-ek ez du zentzurik paragrafo batean, aria-checked ez zaio testu-koadro bati aplikatzen, eta rolik gabeko div bateko aria-label ez da kontuan hartzen. Tresna automatikoek konbinazio horietako gehienak hautematen dituzte.
7. Testu ikusgaiaren kontra doan aria-label
<button aria-label="Submit form">Bidali eskaera</button>Ahots bidezko kontrolak ez du «sakatu Bidali eskaera» ezagutzen, izena beste bat delako; 2.5.3 Etiketa izenean ez du betetzen. Ohikoa da, halaber, interfazea itzuli ondoren ingelesez geratu den aria-label, edo ekintza («Bilatu») deskribatu beharrean ikonoa («lupa») deskribatzen duena.
8. Iragartzen ez duten edo gehiegi iragartzen duten eskualde biziak
Mezua barruan dutela sortuak, edukiontzi erraldoietan, guztiak assertive, edo aria-live tekla bakoitzarekin osorik berriro margotzen den zerrenda baten edukiontzian. Aurreko ikasgaian ikusi genuen; eta gaizki egindako ezkutatzea (ahaztutako aria-hidden, role="presentation" datu-tauletan), ezkutatzeari, baliogabetzeari eta desgaitzeari buruzko ikasgaian.
9. Hierarkia hautsiak
role="tab" tablist gabe, role="option" solteak listbox gabe, role="menuitem" nabigazio-esteka arruntetan (gainera, espero den teklatu-portaera aldatzen du: menu batean gezi-teklekin nabigatzen da, ez Tab teklarekin). Erabili role="menu" mahaigaineko estiloko aplikazio-menuetarako bakarrik, inoiz ez webguneko nabigaziorako.
10. ARIA, irakurgailuari testua irakurtzen «laguntzeko»
aria-label paragrafoetan, «hobeto irakurtzeko», role="text", aria-live eduki estatikoan, tabindex="0" izenburuetan. Irakurgailuak eduki guztia irakurtzen du jada; gehigarri horiek zarata eta funtziorik gabeko geldialdiak baino ez dituzte sortzen.
Funtsezko puntua
ARIAren akats ia guztiak hirutara mugatzen dira: existitzen ez den portaera bat agintzea, egoera bat eguneratzea ahaztea, edo atributu bat eraginik ez duen lekuan jartzea. aria- bat idatzi aurretik, galdetu: zer rol du elementu honek, atributu hau onartzen du, eta nork eguneratuko du?
Nola hauteman
Tresna automatikoak
axe DevTools, WAVE, Lighthouse eta Firefoxen irisgarritasun-ikuskatzaileak modu fidagarrian hautematen dituzte: rol baliogabeak, rolerako onartzen ez diren atributuak, balio okerrak (aria-expanded="yes"), existitzen ez diren id-etarako erreferentziak, id bikoiztuak, eskatzen den guraso-hierarkiarik gabeko rolak, aria-hidden duten elementu fokagarriak, izenik gabeko kontrolak eta rol erredundanteak. Arazoaren zati «sintaktikoa» da, eta komeni da konpilazio bakoitzean exekutatzea (frameworken ikastaroan ikusiko dugu).
Pertsona batek bakarrik hautematen duena
Tresna batek ere ez daki aria-expanded eguneratzen den sakatzean, «Bilatu» izenak benetan deskribatzen duen botoiak egiten duena, role="alert" beharrezkoa zen ala ez, edo menu horrek nav bat izan beharko lukeen. Horretarako:
- Ikuskatu irisgarritasun-zuhaitza nabigatzailearen tresnetan, elkarreragiten duzun bitartean: rolak, izenak eta egoerek espero duzun bezala aldatu behar dute.
- Entzun pantaila-irakurgailu batekin (NVDA Chrome edo Firefoxekin da Espainian konbinazio adierazgarriena) osagai bakoitza geldi dagoenean, fokua jasotzean, aktibatzean eta ixtean. Entzuten duzunak ikusten duzunarekin bat etorri behar du.
- Probatu ahots bidezko kontrolarekin (Windows 11-ren Ahots bidezko sarbidea edo macOSen Ahots bidezko kontrola) «sakatu» eta kontrolen testu ikusgaia esanez: desinkronizatutako
aria-label-ak hautematen ditu. - Berrikusi kodea
aria-bilatuz, eta, agerraldi bakoitzerako, aurkitu hura eguneratzen duen JavaScript lerroa. Ez badago eta egoera bat bada, akatsa da.
Adibidea
Berrikuspenaren aurretik:
<div class="acordeon">
<div class="cabecera" role="button" aria-expanded="false" onclick="toggle(1)">Epeak</div>
<div id="panel1" aria-hidden="true">…</div>
</div>Aurkikuntzak: rola fokurik eta teklaturik gabe (3. araua), toggle()-k eguneratzen ez duen aria-expanded, aria-hidden bidez ezkutatutako panela, baina pantailan ikusgai CSSak huts egiten badu, aria-controls gabe. Ondoren:
<div class="acordeon">
<h3><button type="button" aria-expanded="false" aria-controls="panel1">Epeak</button></h3>
<div id="panel1" hidden>…</div>
</div>boton.addEventListener('click', () => {
const abierto = boton.getAttribute('aria-expanded') === 'true';
boton.setAttribute('aria-expanded', String(!abierto));
panel.hidden = abierto;
});Ohiko akatsa
Osagai bat ontzat ematea axe-k errorerik erakusten ez duelako. axe-k ezin du jakin egoera ez dela eguneratzen, ezta izena engainagarria dela ere. «Zero errore axe-n» beharrezko baldintza da, baina inoiz ez nahikoa.
Laburpena
- Akats tipikoak: rol erredundanteak edo baliogabeak, rola portaerarik gabe, eguneratu gabeko egoerak,
aria-hiddenelementu fokagarrietan edo eduki ikusgaian, erreferentzia hautsiak, onartzen ez diren atributuak, kontraesankorra denaria-label, gaizki sortutako eskualde biziak, hierarkia hautsiak eta ARIA testu estatikoaren gainean. - Tresna automatikoek sintaxia hautematen dute: rol, atributu eta erreferentzia baliogabeak.
- Pertsona batek bakarrik hautematen du semantika: aldatzen ez diren egoerak, izen engainagarriak, rol desegokiak.
- Metodoa: zuhaitza ikuskatzea elkarreragiten duzun bitartean, pantaila-irakurgailuarekin entzutea, ahots bidezko kontrolarekin probatzea, eta
aria-bakoitza nork eguneratzen duen bilatzea.
Ikastaro honetako 7 ikasgai irakurri dituzu: ez itzazu galdu
Sortu zure kontua doan, gorde irakurri duzuna eta jarraitu ikastaroarekin, osorik:
- Ikasgai honetako testa (3 galdera), ikasitakoa egiaztatzeko
- Benetako orriekin egindako ariketa praktikoak
- Zure aurrerapena gordeta: utzi zenuen lekutik jarraituko duzu, edozein gailutatik
- Ikastaroaren egiaztagiria, orduekin, eta 3. mailako doako ziurtagiria azterketa gainditzen duzunean
Zure Google kontuarekin edo zure posta elektronikoarekin bakarrik sartzen zara. Ez duzu pasahitzik behar.