Addaw, joan hasierara Egin dohaintza

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:

GeruzaZerk huts egin dezakeenNola ezagutzen den
Kodea (HTML, CSS, ARIA, JavaScript)Rola falta da, izena hutsik dago, egoera ez da eguneratzen, aria-hidden eduki ikusgarriaren gaineanZuhaitzaren nodoa dagoeneko gaizki dago, eta konbinazio guztietan huts egiten du
Nabigatzailea (kalkulua eta mapaketa)Semantika ezabatzen duen CSS propietate bat, mapatzen ez den atributu batNodoa gaizki dago kodea zuzena izan arren, eta desberdina da nabigatzaile batetik bestera
Pantaila-irakurgailuaEz du iragartzen zuhaitzak erakusten duen zerbait, edo bi aldiz iragartzen duZuhaitza zuzena da, eta akatsa irakurgailu batekin bakarrik agertzen da
Auditorearen konfigurazioaModu okerra, hitzontzikeria, hizkuntzarik gabeko ahotsa, nabigatzailearen Tab ezarpenaZure 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:

  1. aria-labelledby: erreferentziatutako elementuen testua; beste guztiaren gainetik dago.
  2. aria-label.
  3. HTMLaren berezko mekanismoa: lotutako <label>, alt, <caption>, <legend>, input motako botoi baten balioa.
  4. Elementuaren edukia, edukitik izena onartzen duten roletan bakarrik: botoiak, estekak, izenburuak, gelaxkak, fitxak, aukerak; ez testu-eremuak, ezta zerrendak ere.
  5. title eta, 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. 1. urratsa: 1. ErreproduzituAhots-ikustailearen irteera literala, konbinazio zehatza eta bertsioak
  2. 2. urratsa: 2. Aztertu nodoaRola, izena, egoera eta erlazioak zuhaitzean: dagoeneko gaizki badaude, kodea da
  3. 3. urratsa: 3. Aldatu aldagai batBeste nabigatzaile bat irakurgailu berarekin, beste irakurgailu bat nabigatzaile berarekin
  4. 4. urratsa: 4. Murriztu gutxieneko kasuraKopiatu osagaia HTML lokal batera, zer estilok edo script-ek hausten duen ikusteko
  5. 5. urratsa: 5. Egotzi eta dokumentatuAurkikuntza kausarekin eta gomendioarekin, edo euskarri-oharra
ADDAW · Irisgarritasun-ikastaroak
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

  1. Erreproduzitu eta idatzi sintoma literala. Kopiatu ahots-ikustailearen irteera, eta idatzi konbinazio zehatza eta haren bertsioak.
  2. 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.
  3. 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.
  4. 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.
  5. 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 du aria-hidden bidez, 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-ek false balioan 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 dio list-style: none bidez buletak kentzen zaizkien zerrenda batzuei. HTMLa zuzena da, baina zuhaitza ez.
  • Erreferentzia hautsiak. Existitzen ez den edo bikoiztuta dagoen id bati seinalatzen dioten aria-labelledby edo aria-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, title edo placeholder.
  • 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 €)