7. ikasgaia (10 guztira) · 13 min irakurtzeko · Berrikuspen-data: 26/10/2026
Sintomatik kausara: irisgarritasun-zuhaitza aztertu
Ikasgai ireki bat irakurtzen ari zara. Matrikulatu testak eta ariketak egiteko, zure aurrerapena gordetzeko eta ziurtagiria lortzeko.
Matrikulatu · 4. maila (49 €)Pantaila-irakurgailu batek zerbait bitxia iragartzen duenean, edo ezer iragartzen ez duenean, auditoreak galdera bati erantzun behar dio aurkikuntza idatzi aurretik: arazoa kodean dago, nabigatzailean, irakurgailuan ala bere ekipoaren konfigurazioan? Eta garapen-taldeak «NVDAk “botoia” dio» baino zerbait gehiago behar du: kausa behar du. Lehen ikasgaian ikusi zenuen irakurgailuak irisgarritasun-zuhaitza irakurtzen duela, eta proba-protokoloan ebidentzia gisa erabiliko dugu; honetan, hura aztertzen ikasiko duzu, sintomatik kausara igarotzeko.
Geruzak: kodetik ahotsera
HTMLaren eta erabiltzaileak entzuten duenaren artean hainbat geruza daude. Nabigatzaileak DOMa, CSSa eta ARIA konbinatzen ditu irisgarritasun-zuhaitza kalkulatzeko (rolak, izenak, egoerak, erlazioak). Ondoren, sistema eragilearen irisgarritasun-APIaren bidez erakusten du: UI Automation eta IAccessible2 Windowsen, macOSen irisgarritasun-APIa, UIAccessibility iOSen edo Androidena. Azkenik, irakurgailuak informazio hori interpretatzen du eta ahoz adierazten du bere konfigurazioaren arabera. Akats bat edozein geruzatan sar daiteke:
| Geruza | Zerk huts egin dezakeen | Nola ezagutzen den |
|---|---|---|
| Kodea (HTML, CSS, ARIA, JavaScript) | Rola falta da, izena hutsik dago, egoera ez da eguneratzen, aria-hidden eduki ikusgarriaren gainean | Zuhaitzaren nodoa dagoeneko gaizki dago, eta konbinazio guztietan huts egiten du |
| Nabigatzailea (kalkulua eta mapaketa) | Semantika ezabatzen duen CSS propietate bat, mapatzen ez den atributu bat | Nodoa gaizki dago kodea zuzena izan arren, eta desberdina da nabigatzaile batetik bestera |
| Pantaila-irakurgailua | Ez du iragartzen zuhaitzak erakusten duen zerbait, edo bi aldiz iragartzen du | Zuhaitza zuzena da, eta akatsa irakurgailu batekin bakarrik agertzen da |
| Auditorearen konfigurazioa | Modu okerra, hitzontzikeria, hizkuntzarik gabeko ahotsa, nabigatzailearen Tab ezarpena | Zure ekipoan bakarrik erreproduzitzen da |
Azterketa-tresnak
Chrome eta Edge
Garatzaileentzako tresnetan (F12), Elementuak panelean, Irisgarritasuna fitxak hautatutako nodoaren posizioa erakusten du irisgarritasun-zuhaitzean, ARIA atributuak eta kalkulatutako propietateak: rola, izena eta zer iturritatik datorren (aria-labelledby, aria-label, edukia, title…), eta fokagarria edo zabalduta bezalako egoerak. Bertsio berriek, gainera, orriaren irisgarritasun-zuhaitz osoa ikusteko aukera ematen dute, DOMaren ordez.
Firefox
Irisgarritasun-ikuskatzaileak (garatzaileentzako tresnetako Irisgarritasuna fitxa) zuhaitz osoa eta nodo bakoitzaren propietateak erakusten ditu, eta auditoria egiteko oso praktikoak diren utilitateak gehitzen ditu: kontraste-, teklatu- eta testu-etiketa-arazoen egiaztapena, tabulazio-ordenaren bistaratzea orriaren beraren gainean, eta kolore-ikusmenaren urritasunen simulazioa.
Safari
Garatzaileentzako funtzioak Safariren ezarpen aurreratuetan aktibatuta daudela, Web Inspector-ak irisgarritasun-atal bat erakusten du Elementuak panelaren alboko barran, WebKitek erakusten dituen rolarekin, etiketarekin eta egoerekin. Erabilgarria da, VoiceOverrek Safarirekin askotan Chromerekin ez bezala jokatzen duelako.
Sistemaren eta irakurgailuaren tresnak
Accessibility Insights for Windows-ek (Microsoft, doakoa) eta macOSeko Irisgarritasun-ikuskatzaileak (Xcode-rekin batera dator) sistemaren APIra benetan iristen dena erakusten dute. NVDAn, NVDA+F1 teklek uneko objektuaren garatzaile-informazioa isurtzen dute erregistro-ikustailera: rola, izena, egoerak eta atributuak, irakurgailuak jasotzen dituen bezala.
Nola kalkulatzen den izen irisgarria
4.1.2 Izena, funtzioa eta balioa eta 2.5.3 Etiketa izenean irizpideen aurkikuntza askoren azalpena izen irisgarria kalkulatzeko algoritmoan dago (W3Cren Accessible Name and Description Computation 1.2). Sinplifikatuta, lehentasun-ordena hau da:
aria-labelledby: erreferentziatutako elementuen testua; beste guztiaren gainetik dago.aria-label.- HTMLaren berezko mekanismoa: lotutako
<label>,alt,<caption>,<legend>,inputmotako botoi baten balioa. - Elementuaren edukia, edukitik izena onartzen duten roletan bakarrik: botoiak, estekak, izenburuak, gelaxkak, fitxak, aukerak; ez testu-eremuak, ezta zerrendak ere.
titleeta, eremuetan,placeholder, azken baliabide gisa (ez dira etiketa gisa erabili behar).
Chromeren panelak iturri posibleak zerrendatzen ditu, eta zein erabili den eta zein baztertu diren adierazten du. Horrekin azal dezakezu, adibidez, zergatik iragartzen den «Bidali kontsulta» gisa «Bilatu» erakusten duen botoi bat: eduki ikusgarria ordezten duen aria-label bat du.
<!-- Izena hutsik: ikonoa CSS hondo bat da, eta ez dago testurik -->
<a href="/carrito" class="icono-carrito"></a>
<!-- Izen zuzena: testu irisgarria eta SVG apaingarria ezkutatuta -->
<a href="/carrito">
<svg aria-hidden="true" focusable="false">…</svg>
<span class="sr-only">Saskia</span>
</a>Adibidea
Udal baten webgunea, mugikorreko ikuspegia. Hanburgesa-menuaren botoia «botoia» gisa bakarrik iragartzen da NVDAn. Chromeren Irisgarritasuna fitxan, izena hutsik agertzen da: ez dago aria-labelledby-rik ez aria-label-ik, edukia izenbururik gabeko SVG bat da, eta ez dago title-rik. Ez dago aria-expanded-ik ere. Kausa: izenik eta egoerarik gabeko ikono-botoia. Irizpideak: 4.1.2 Izena, funtzioa eta balioa (eta 1.1.1 Testua ez den edukia, alternatibarik gabeko ikonoagatik). Gomendioa: aria-label="Menua" edo bisualki ezkutatutako testua, eta irekitzean eta ixtean aldatzen den aria-expanded. Panelaren pantaila-argazkia, izena hutsik duela, txostenera doa ebidentzia gisa.
Infografia · Prozesua
Sintomatik kausara: irakurgailuarekin ikusitako akats bat isolatu
Bost urrats, arazoa kodean, nabigatzailean, irakurgailuan ala zure ekipoan dagoen jakiteko
- 1. urratsa: 1. ErreproduzituAhots-ikustailearen irteera literala, konbinazio zehatza eta bertsioak
- 2. urratsa: 2. Aztertu nodoaRola, izena, egoera eta erlazioak zuhaitzean: dagoeneko gaizki badaude, kodea da
- 3. urratsa: 3. Aldatu aldagai batBeste nabigatzaile bat irakurgailu berarekin, beste irakurgailu bat nabigatzaile berarekin
- 4. urratsa: 4. Murriztu gutxieneko kasuraKopiatu osagaia HTML lokal batera, zer estilok edo script-ek hausten duen ikusteko
- 5. urratsa: 5. Egotzi eta dokumentatuAurkikuntza kausarekin eta gomendioarekin, edo euskarri-oharra
Irakurri infografia testu gisa
Bost urratseko prozesua, sekuentzian, pantaila-irakurgailu batekin ikusitako arazo bat diagnostikatzeko. 1. urratsa, erreproduzitu: idatzi ahots-ikustailearen irteera literala eta konbinazio zehatza, bertsioekin. 2. urratsa, aztertu nodoa irisgarritasun-zuhaitzean: egiaztatu rola, izena, egoera eta erlazioak; dagoeneko gaizki badaude, kausa kodean edo nabigatzailean dago. 3. urratsa, aldatu aldagai bakar bat aldi bakoitzean: beste nabigatzaile bat irakurgailu berarekin eta beste irakurgailu bat nabigatzaile berarekin; konbinazio guztietan huts egiten badu, kodea da. 4. urratsa, murriztu fitxategi lokal bateko gutxieneko kasu batera, zer estilok, script-ek edo frameworkek eragiten duen aurkitzeko. 5. urratsa, egotzi eta dokumentatu: webgunearen aurkikuntza bere kausarekin eta gomendioarekin, edo euskarri-oharra, eragindako konbinazioarekin.
Akatsa urratsez urrats isolatu
- Erreproduzitu eta idatzi sintoma literala. Kopiatu ahots-ikustailearen irteera, eta idatzi konbinazio zehatza eta haren bertsioak.
- Aztertu nodoa. Rola, izena, egoera eta erlazioak ereduak eskatzen dituenak dira? Zuhaitza dagoeneko gaizki badago, kausa kodean dago edo nabigatzaileak hura interpretatzeko moduan: berrikusi HTMLa, CSSa eta osagaia aldatzen duen script-a.
- Aldatu aldagai bakar bat aldi bakoitzean. Irakurgailu bera beste nabigatzaile batekin; nabigatzaile bera beste irakurgailu batekin. Guztietan huts egiten badu, ia ziur kodea da. Bakar batean huts egiten badu, susmatu euskarri-arazo bat edo nabigatzailearen edo irakurgailuaren akats bat.
- Murriztu gutxieneko kasu batera. Kopiatu osagaia HTML fitxategi lokal batera, ezinbestekoarekin. Gutxieneko kasuak funtzionatzen badu, kausa kendu duzun zerbaitean dago: estilo-orri batean, script batean, frameworkean.
- Egotzi eta dokumentatu. Webgunearen aurkikuntza, bere kausa teknikoarekin eta gomendioarekin, edo bestela euskarri-oharra, eragindako konbinazioarekin. Hurrengo ikasgaiak azaltzen du erabaki hori nola hartu.
Zuhaitzak bakarrik agerian uzten dituen kausak
- Heredatutako
aria-hidden="true". Leiho modal bat irekitzean, script batek eduki nagusia ezkutatzen duaria-hiddenbidez, eta ixtean kentzea ahazten zaio. Orria ezin hobeto ikusten da, baina irakurgailuarentzat hutsik dago. Ikuskatzailean, nodo guztiak ezikusitzat agertzen dira. - Egoera izoztuak. Panela bisualki irekitzen da, baina
aria-expanded-ekfalsebalioan jarraitzen du, script-ak CSS klase bat aldatzen duelako eta ez atributua. - Semantika aldatzen duen CSSa.
display: contents-ek botoien edo taulen rola ezabatu izan du hainbat nabigatzailetan, eta WebKitek zerrenda gisa erakusteari uzten diolist-style: nonebidez buletak kentzen zaizkien zerrenda batzuei. HTMLa zuzena da, baina zuhaitza ez. - Erreferentzia hautsiak. Existitzen ez den edo bikoiztuta dagoen
idbati seinalatzen diotenaria-labelledbyedoaria-describedby: izena edo deskribapena hutsik edo oker geratzen dira.
Ohiko akatsa
Ikuskatzailean itsu-itsuan fidatzea. Garatzaileentzako tresnen zuhaitza nabigatzailearen eredua da, ez irakurgailu bakoitzak azkenean esaten duena; irakurgailuak bere heuristikak aplika ditzake (JAWSek etiketak ondorioztatzean egiten duen bezala). Ikuskatzaileak dio zer eskaintzen duen nabigatzaileak; irakurgailuarekin egindako probak, zer jasotzen duen pertsonak. Biak behar dira.
Probatu zuk zeuk
Ireki edozein webgune, hautatu Chromen ikonoa bakarrik duen botoi bat, eta begiratu Irisgarritasuna fitxan haren izen kalkulatua eta zer iturritatik datorren. Ondoren, editatu Elementuak panelean haren aria-label (edo gehitu), eta itzuli botoira NVDArekin: egiaztatu iragarpena aldatu egiten dela. Errepikatu azterketa Firefoxen eta alderatu.
Laburpena
- Akats bat kodean, nabigatzailean, irakurgailuan edo auditorearen konfigurazioan sor daiteke; irisgarritasun-zuhaitzari esker jakin daiteke zer geruzatan dagoen.
- Chrome eta Edge (Irisgarritasuna fitxa), Firefox (Irisgarritasun-ikuskatzailea), Safari (Web Inspector), Accessibility Insights, macOSeko ikuskatzailea eta NVDA+F1 dira azterketa-tresnak.
- Izen irisgarriak ordena bati jarraitzen dio:
aria-labelledby,aria-label, berezko mekanismoa, edukia eta, azkenik,titleedoplaceholder. - Isolatzeko: erreproduzitu, aztertu, aldatu aldagai bat aldi bakoitzean, murriztu gutxieneko kasura, egotzi eta dokumentatu.
- Ikuskatzaileak ez du irakurgailuarekin egindako proba ordezten: osatu egiten du, eta kausa teknikoa ematen dio txostenari.
Ikastaro honetako 3 ikasgai irakurri dituzu: ez itzazu galdu
Sortu zure kontua, 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 4. mailako ziurtagiria azterketa gainditzen duzunean
Zure Google kontuarekin edo zure posta elektronikoarekin bakarrik sartzen zara. Ez duzu pasahitzik behar.
Matrikulatu · 4. maila (49 €)