Addaw, joan hasierara Egin dohaintza

3. ikasgaia (10 guztira) · 15 min irakurtzeko · Berrikuspen-data: 26/10/2026

Kodetik irakurgailura: irisgarritasun-zuhaitza, APIak eta irakurgailuaren moduak

Ikasgai ireki bat irakurtzen ari zara. Matrikulatu doan testak eta ariketak egiteko, zure aurrerapena gordetzeko eta ziurtagiria lortzeko.

Aurreko ikasgaian ikusi genuen ARIAk irisgarritasun-zuhaitzean soilik jarduten duela; N3-C1 ikastaroan ezagutu zenuen zuhaitz hori. Orain ARIAren ikuspegitik begiratuko diogu: zer bide egiten duen atributu batek zure kodetik nabigatzen duenaren belarriraino (edo hatzetaraino, braille-lerro batekin), zergatik entzuten den markaketa bera desberdin NVDAn, JAWSen, VoiceOverren edo TalkBacken, eta nola aldatzen duten pantaila-irakurgailuaren moduek rol bakoitzaren esanahia.

Kate osoa: DOMetik pertsonara

Zure HTMLaren eta erabiltzailearen artean lau katebegi daude, eta zerbait «iragartzen ez denean», akatsa edozeinetan egon daiteke.

  1. DOMa. Dokumentua memorian dagoen bezala: zure HTMLa eta JavaScriptek gero aldatu duen guztia. Zuzenean kontrolatzen duzun gauza bakarra da.
  2. Irisgarritasun-zuhaitza. Nabigatzaileak DOMa zeharkatzen du, eta nodo esanguratsu bakoitzerako bere rola, izena, deskribapena, egoerak, propietateak eta erlazioak kalkulatzen ditu. Esanahirik ematen ez duena baztertzen du (<div> eta <span> generiko gehienak) eta ezkutatuta dagoena. ARIAk hementxe esku hartzen du: nabigatzaileak HTMLtik ondorioztatuko lukeena gainidazten edo osatzen du.
  3. Plataformaren irisgarritasun-APIa. Nabigatzaileak ez du zuzenean hitz egiten pantaila-irakurgailuarekin: zuhaitza sistema eragilearen irisgarritasun-interfazearen bidez argitaratzen du. Windowsen, UI Automation eta IAccessible2 (MSAA zaharraz gain); macOSen, Cocoaren irisgarritasun-APIa (NSAccessibility); iOSen, UIAccessibility; Linuxen, ATK eta AT-SPI; Androiden, sistemaren irisgarritasun-APIa. W3Cren korrespondentzia-espezifikazioek (Core-AAM ARIA rol eta atributuetarako, HTML-AAM HTML elementuetarako) adierazten dute nola itzuli behar den rol eta egoera bakoitza API horietako bakoitzera.
  4. Laguntza-teknologia. Pantaila-irakurgailuak, pantaila-handigailuak edo ahots bidezko kontrolak API hori kontsultatzen dute, haren gertaerak jasotzen dituzte eta informazioa nola aurkeztu erabakitzen dute: zer hitz erabiltzen duten rolerako, zer ordenatan, zer erakusten duten braille-lerroan.

Infografia · Prozesua

Kodetik irakurgailura: bost katebegiak

Zer bide egiten duen ARIA atributu batek laguntza-teknologia bat erabiltzen duen pertsonarengana iritsi arte

  1. 1. urratsa: Zure kodea (DOMa)HTMLa, ARIA atributuak eta JavaScripten aldaketak: kontrolatzen duzun gauza bakarra.
  2. 2. urratsa: Irisgarritasun-zuhaitzaNabigatzaileak rola, izena, egoerak eta erlazioak kalkulatzen ditu. Hemen jarduten du ARIAk.
  3. 3. urratsa: Plataformaren APIaUI Automation, IAccessible2, NSAccessibility, UIAccessibility, AT-SPI…
  4. 4. urratsa: Laguntza-teknologiaIrakurgailuak, handigailuak edo ahots bidezko kontrolak APIa eta haren gertaerak kontsultatzen dituzte.
  5. 5. urratsa: ErabiltzaileaAhotsa, braillea edo nabarmentzea jasotzen du: informazio bera edozein irakurgailutan.
ADDAW · Irisgarritasun-ikastaroak
Irakurri infografia testu gisa

Web-interfaze baten informazioa erabiltzailearengana nola iristen den erakusten duen bost urratseko prozesua. 1. urratsa, zure kodea edo DOMa: HTMLa, ARIA atributuak eta JavaScriptekin egindako aldaketak, garatzen duenak kontrolatzen duen gauza bakarra baita. 2. urratsa, irisgarritasun-zuhaitza: nabigatzaileak nodo bakoitzaren rola, izena, egoerak eta erlazioak kalkulatzen ditu; urrats honetan jarduten du ARIAk. 3. urratsa, plataformaren irisgarritasun-APIa: nabigatzaileak zuhaitza argitaratzen du UI Automation eta IAccessible2 bidez Windowsen, NSAccessibility bidez macOSen, UIAccessibility bidez iOSen, AT-SPI bidez Linuxen edo Androiden APIaren bidez. 4. urratsa, laguntza-teknologia: pantaila-irakurgailuak, pantaila-handigailuak edo ahots bidezko kontrolak API hori kontsultatzen dute eta haren gertaerak entzuten dituzte. 5. urratsa, erabiltzaileak informazioa ahots, braille edo nabarmentze gisa jasotzen du, eta informazio bera jaso behar du edozein irakurgailurekin.

Funtsezko puntua

Zuk kontrolatzen duzu lehenengo katebegia; nabigatzaileak, bigarrena eta hirugarrena; laguntza-teknologiaren fabrikatzaileak, laugarrena. Horregatik, «espezifikazioaren arabera baliozkoa» izateak ez du beti esan nahi «leku guztietan berdin dabilela», eta horregatik da hain errentagarria 1. araua (HTML natiboa erabiltzea): elementu natiboek dituzte kate osoko korrespondentziarik zaharrenak, probatuenak eta euskarri onenekoak.

Zer erabakitzen duen ARIAk eta zer nabigatzaileak

Elementu batek role atributua duenean, nabigatzaileak rol hori erakusten du, inplizituaren ordez. Badira itxuraz arraroak diren portaera asko azaltzen dituzten ñabardurak:

  • role atributuak balio-zerrenda bat onartzen du. Nabigatzaileak ezagutzen duen lehenengoa erabiltzen du, eta gainerakoak baztertzen ditu. role="switch checkbox" etengailu gisa erakusten da switch ezagutzen den lekuan, eta kontrol-lauki gisa ezagutzen ez den lekuan. Balio bat ere baliozkoa ez bada (role="boton"), elementuak bere rol inplizitua mantentzen du, ezer idatzi ez bazenu bezala.
  • Rol batzuek seme-alaba aurkezpenezkoak dituzte. button, checkbox, img, tab, switch, slider, progressbar edo option bezalako roletan, espezifikazioak adierazten du edukia lautu egiten dela: nabigatzaileak haren testua erakusten du, baina barruko edozein semantika (izenburu bat, zerrenda bat, taula bat) zuhaitzetik desagertzen da. Horregatik, botoi baten barruko izenburu batek izenburu izateari uzten dio, eta modu zuzena alderantzizkoa da: botoia izenburuaren barruan.
  • Aldaketek gertaerak sortzen dituzte. JavaScriptek aria-expanded, aria-checked edo eskualde bizi baten testua aldatzen duenean, nabigatzaileak zuhaitza eguneratzen du eta irisgarritasun-gertaera bat jaurtitzen du («egoera aldatu da», «izena aldatu da», «edukia agertu da»). Laguntza-teknologiak gertaera horiek entzuten ditu. Horrela betetzen da, praktikan, 4.1.2 Izena, funtzioa eta balioa irizpidearen aldaketak jakinaraztea eskatzen duen zatia.
  • Nabigatzaileak konpondu ere egiten du markaketa kontraesankorra, gatazkak ebazteko arauekin (semantika ezkutatzeari eta baliogabetzeari buruzko ikasgaian ikusiko ditugu). Ez fidatu konponketa horietaz.

Ohiko akatsa

<div role="button" tabindex="0" class="tarjeta">
  <h3>Erroldatzea</h3>
  <p>Alta, baja eta helbide-aldaketa</p>
</div>

button-ek seme-alaba aurkezpenezkoak dituenez, <h3> zuhaitzetik desagertzen da: izenburuen bidez nabigatzen duenak ez du «Erroldatzea» aurkitzen, eta botoiak testu osoa jasotzen du izen gisa, dena batera. Txartelak beste orri batera eramaten badu, egokiena esteka bat duen izenburu bat da: <h3><a href="/empadronamiento">Erroldatzea</a></h3>, deskribapena estekatik kanpo duela.

Ez bilatu esaldi bera irakurgailu guztietan

<button aria-expanded="false">Menua</button> bera ez da berdin entzuten leku guztietan: irakurgailu bakoitzak bere erara ordenatzen ditu izena, rola eta egoera, bere hitzak erabiltzen ditu, eta pertsonak aukeratu duen hitzontzitasuna aplikatzen du. Normala da. Bat etorri behar duena informazioa da (izena «Menua» da, botoi bat da, tolestuta dago), ez esaldia. Irakurgailuren batean zati horietako bat falta bada, orduan bai, arazo bat dago.

Pantaila-irakurgailuaren moduak

Windowsen gehien erabiltzen diren irakurgailuek, NVDAk eta JAWSek, orriaren irudikapen birtual baten gainean lan egiten dute, eta bi funtzionamendu-modu dituzte, tekla bakoitzak egiten duena erabat aldatzen dutenak:

  • Arakatze-modua (NVDA) edo kurtsore birtuala (JAWS): sakatzeak ez dira orrira iristen. Gezi-teklek lerroz lerro irakurtzen dute, eta letrak nabigazio azkarreko laster-teklak dira; adibidez, NVDAn H teklak hurrengo izenburura salto egiten du, eta D teklak hurrengo landmarkera (main edo nav bezalako erreferentzia-eskualdea).
  • Foku-modua (NVDA) edo formulario-modua (JAWS): sakatzeak orrira pasatzen dira, eremu batean idatzi edo kontrol bat gezi-teklekin erabili ahal izateko. Irakurgailuak modua automatikoki aldatzen du testu-eremu batean eta widget konposatu askotan sartzean, hala nola aukera-zerrendetan, zuhaitzetan edo saretan; pertsonak ere eskuz alda dezake (NVDAn, NVDA + Zuriune-barra erabiliz).

macOSeko VoiceOverrek ez du dualtasun hori: teklak orrira iristen dira, Control + Option teklekin konbinatzen ez badira, eta elementu motaren araberako nabigazioa errotorearekin egiten da. Mugikorrean, VoiceOver eta TalkBack keinuekin erabiltzen dira.

ARIArentzako ondorioa zuzena da: rolak eragina du moduan. Gezi-teklei erantzuten dien osagai bat programatzen baduzu (fitxa batzuk, aukera-zerrenda bat, karpeta-zuhaitz bat) baina widget-rolik ematen ez badiozu, arakatze-moduan gezi-teklak ez dira inoiz zure kudeatzaileetara iristen: irakurgailuak kontsumitzen ditu hurrengo lerroa irakurtzeko. Osagaiak teklatuarekin funtzionatzen du irakurgailurik gabe, eta huts egiten du irakurgailuarekin. Widget-rolak dira irakurgailuak teklatua uzteko behar duen seinalea.

role="application": ia inoiz sakatu behar ez duzun etengailua

role="application" atributuak laguntza-teknologiari adierazten dio eremu hori sakatze guztiak berak kudeatzen dituen aplikazio bat dela. Orduan, irakurgailu askok teklatua atzemateari uzten diote: eremu horren barruan, pertsonak galdu egiten ditu gezi-teklen bidezko irakurketa, izenburuen arteko saltoak eta nabigazio-laster-teklak. Teklatu-eredu propio eta osoa duten eta widget-rol egokirik ez duten azaleretan bakarrik du zentzua (editore grafiko bat, kontrol propioak dituen mapa bat), ahalik eta elementurik txikienera mugatuta.

Ohiko akatsa

<!-- Okerra: intranet osoa «aplikazio» bihurtzen da -->
<body role="application">
  …
</body>

Aplikazioaren «laster-teklek funtziona dezaten» egin ohi da, eta emaitza da pantaila-irakurgailua erabiltzen duen pertsonak ezin dituela testuak, taulak edo mezuak irakurri bere ohiko metodoekin. Laster-teklak irakurgailuarenekin talka egiten badute, irtenbidea laster-teklak berrikustea da (eta 2.1.4 Karaktere bakarreko laster-teklak betetzea), ez irakurgailua desaktibatzea.

Nola ikusi irakurgailuak ikusten duena

Ez da beharrezkoa zuhaitzean zer dagoen asmatzea. Tresna hauek erakusten dute:

  • Chrome eta Edge: Elementuak panela, Irisgarritasuna fitxa. Rola, kalkulatutako izena eta haren jatorria, egoerak eta propietateak erakusten ditu, eta zuhaitz osoa ikusteko aukera ematen du.
  • Firefox: Irisgarritasun-ikuskatzaileak zuhaitza, nodo bakoitzaren propietateak eta ohiko arazoei buruzko abisuak erakusten ditu. Safarin, web-ikuskatzaileak nodoaren irisgarritasun-propietateak erakusten ditu.
  • Plataforma-maila: Accessibility Insights for Windows-ek eta macOSeko Xcode-ren Irisgarritasun-ikuskatzaileak sistema eragileak jasotzen duena erakusten dute; erabilgarria da nabigatzaileak zerbait zuzena erakusten duenean eta irakurgailuak beste modu batean jokatzen duenean.
  • Irakurgailua bera: NVDAren Hizketa-ikustaileak (NVDA menua, Tresnak) esaten duena idatziz erakusten du; konparatzeko eta ebidentziak gordetzeko balio du.

Probatu zuk zeuk

Ireki Chromen mugikorrerako goitibeherako menua duen webgune bat (txikitu leihoa, behar izanez gero). Ikuskatu menuaren botoia, ireki Irisgarritasuna fitxa eta idatzi haren rola, izena eta aria-expanded-en balioa. Sakatu botoia eta egiaztatu balioa aldatzen den. NVDA baduzu, aktibatu Hizketa-ikustailea eta konparatu. Panelak «zabalduta» badio menua itxita dagoela, teoriako azken ikasgaian ikusiko ditugun akatsetako bat aurkitu duzu.

Laburpena

  • Informazioa DOMetik irisgarritasun-zuhaitzera bidaiatzen du, handik plataformaren APIra eta handik laguntza-teknologiara; ARIAk DOMetik zuhaitzerako urratsean jarduten du.
  • Nabigatzaileak zerrendako lehenengo rol baliozkoa erabiltzen du, seme-alaba aurkezpenezkoak dituzten rolen edukia lautzen du, eta gertaerak jaurtitzen ditu egoerak eta testuak aldatzen direnean.
  • Irakurgailu bakoitzak bere erara ahoskatzen du: eskatu informazio bera iristea, ez esaldi bera.
  • NVDAn eta JAWSen, rolak eragina du foku-modura igarotzean; widget-rolik gabeko gezi-teklak dituen osagai batek huts egiten du irakurgailuarekin, eta role="application"-ek irakurketa normala desaktibatzen du; beraz, ia inoiz ez dago justifikatuta.
  • Ikuskatu zuhaitza nabigatzailearen tresnekin eta entzun Hizketa-ikustailearekin, ezer ontzat eman aurretik.

Ikastaro honetako 2 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.