Addaw, joan hasierara Egin dohaintza

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

Osagai konplexuak pantaila-irakurgailuarekin: APGko ereduak probatu

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

Matrikulatu · 4. maila (49 €)

Osagai pertsonalizatuetan (fitxak, osatze automatikoa duten konbinazio-koadroak, elkarrizketa-koadroak, goitibeherako menuak, graduatzaileak) biltzen da auditoria baten aurkikuntza larrien zati handi bat, eta, hain zuzen ere, tresna automatikoek ebaluatzen ez dakitena dira. NVDAri eta JAWSi buruzko ikasgaian komandoak ikasi zenituen; honetan, osagai bakoitza ebaluatzeko metodo bat ikasiko duzu: zer iragarri beharko lukeen, zer tekla onartu behar dituen, nora joan behar duen fokuak eta nola egiaztatu mahaigainean eta mugikorrean. Erreferentzia W3Cren APG (leiho berri batean irekitzen da) da (ARIA Authoring Practices Guide, ARIA egiteko jardunbideen gida); erabiltzaileek espero duten portaera deskribatzen du, irakurgailuak interpretatzeko prestatuta daudena.

Metodoa: kontratua, teklatua, irakurgailua eta mugikorra

  1. Identifikatu eredua bere funtzioaren arabera. Ezer ukitu aurretik, erabaki zer den osagaia erabiltzen duenarentzat: fitxa-multzo bat, edukia zabaltzen duen botoi bat (disclosure), iradokizunak dituen konbinazio-koadro bat, elkarrizketa-koadro bat? Garapen-taldeak aukeratu duen rola okerra izan daiteke; zure erreferentzia osagaiak egiten duena da, ez kodeak dioena.
  2. Idatzi espero den kontratua. APGko eredutik, atera hiru gauza: iragarri behar diren rola, izena eta egoerak; funtzionatu behar duten teklak; eta nora joaten den fokua irekitzean, ixtean edo hautatzean.
  3. Probatu teklatuarekin bakarrik, irakurgailurik gabe, teklatuari eta zoomari buruzko ikasgaian ikusi zenuen bezala. Teklatuarekin erabiltzen ez bada, dagoeneko 2.1.1 Teklatua irizpidearen akats bat duzu, eta irakurgailuak ñabardurak bakarrik gehituko ditu.
  4. Probatu NVDArekin bi moduetan. Iritsi osagaira Tab teklarekin (irakurgailua formulario modura pasatu ohi da) eta baita arakatze-moduan ere, gezi-teklekin edo nabigazio bizkorreko letrekin, eta aktibatu Sartu edo Zuriune-barrarekin. Osagai askok modu batean funtzionatzen dute eta bestean huts egiten dute.
  5. Errepikatu mugikorrean VoiceOverrekin edo TalkBackekin: irristatu osagaira arte, aktibatu ukitu bikoitzarekin eta egiaztatu egoerak han ere iragartzen direla.

Funtsezko puntua

APG ez da araua: osagai batek 2.1.1 Teklatua eta 4.1.2 Izena, funtzioa eta balioa bete ditzake beste teklatu-eredu batekin. Baina kodeak ARIA rol bat deklaratzen duenean, adibidez role="tablist", irakurgailuak rol hori iragartzen du, eta erabiltzaileak hari lotutako teklak espero ditu. Existitzen ez den portaera bat agintzen duen rol batek rolik ez izateak baino nahasmen handiagoa sortzen du.

Erreferentzia-taula: zer iragarri behar den eta zer tekla probatu

Hitz zehatzak aldatu egiten dira irakurgailu eta hizkuntza batetik bestera; garrantzitsuena informazioa iristea da. Erabili taula hau proba-gidoi gisa, eta zabaldu zure laginean agertzen diren APGko ereduekin.

OsagaiaIragarri behar daProbatu beharreko teklakAkats tipikoa
Zabaltzeko botoia (disclosure)Izena, «botoia», tolestuta edo zabalduta (aria-expanded)Sartu eta Zuriune-barra; Tab agerian geratutako edukirantzEgoera ez da aldatzen, edo edukia DOMaren amaieran txertatzen da, botoitik urrun
Fitxak«Fitxa», izena, hautatuta, posizioa («4tik 2.»)Gezi-teklak fitxen artean; Tab panelera; Hasiera eta Amaiera aukerakoakGezi-teklek ez dute ezer egiten, edo ez da iragartzen zein dagoen hautatuta
Osatze automatikoa duen konbinazio-koadroa«Konbinazio-koadroa», izena, zabalduta; aukera aktiboa mugitzean; iradokizun kopuruaIdatzi, Behera gezia, Sartu, EscBisualki nabarmendutako aukera ez da iragartzen
Elkarrizketa-koadro modala«Elkarrizketa-koadroa» eta bere izenburuaTab barruan zirkulatzen da; Esc teklak ixten du; fokua ireki zuen botoira itzultzen daHondoa irisgarri jarraitzen du kurtsore birtualarekin; fokua atzean geratzen da
AkordeoiaIzenburu baten barruko botoia, tolestuta edo zabaldutaSartu eta Zuriune-barraBotoirik gabeko izenburu klikagarria: ez erabilgarria, ez iragarria
Taula ordenagarriaZutabe-goiburua, bere ordenatze-egoerarekin (aria-sort)Sartu edo Zuriune-barra goiburuko botoiaren gaineanOrdena gezi bisual batekin bakarrik adierazten da
Graduatzailea«Graduatzailea», izena, balioa (aria-valuetext, zenbakia nahikoa ez bada)Gezi-teklak, Hasiera, Amaiera, Orri gora eta Orri beheraBalioa ez da iragartzen; iOSen, gora edo behera irristatzeak ez du doitzen

Adibide xehatua: osatze automatikoa duen konbinazio-koadroa

Huts gehien egiten duen osagaia da, eta erabilienetako bat: egoitza elektronikoetako kale- eta udalerri-bilatzaileak, garraio-webguneetako jatorria eta helmuga, denden bilatzaileak. WAI-ARIA 1.2 (leiho berri batean irekitzen da) eta APGko ereduaren arabera, eremuak role="combobox", aria-expanded eta aria-controls ditu, role="listbox" duen zerrenda bati seinalatzen diola; iradokizun bakoitza role="option" bat da, eta fokua eremuan geratzen da, aukera aktiboa aria-activedescendant bidez jakinarazten den bitartean.

Pantaila ikusten duenarentzat bakarrik funtzionatzen duen bertsioa:

<input type="text" id="calle" placeholder="Kalea">
<ul class="sugerencias">
  <li class="activa">Mayor kalea</li>
  <li>Mayor Alta kalea</li>
</ul>

Kontratu osoa irisgarritasun-zuhaitzari erakusten dion bertsioa:

<label for="calle">Kalea</label>
<input id="calle" type="text" role="combobox"
       aria-autocomplete="list" aria-expanded="true"
       aria-controls="lista-calles"
       aria-activedescendant="calle-op1">
<ul id="lista-calles" role="listbox" aria-label="Iradokitako kaleak">
  <li id="calle-op1" role="option" aria-selected="true">Mayor kalea</li>
  <li id="calle-op2" role="option" aria-selected="false">Mayor Alta kalea</li>
</ul>

Proba-gidoia NVDArekin eta ahots-ikustailea irekita:

  1. Tab eremura arte: izena («Kalea»), konbinazio-koadroaren rola eta editagarria dela iragarri behar dira.
  2. Idatzi «May»: jakinarazten da iradokizunak daudela, zabalduta egoerara aldatuz edo emaitza kopurua duen mezu batekin?
  3. Behera gezia: «Mayor kalea» irakurtzen da eta, irakurgailuaren arabera, zerrendako posizioa?
  4. Sartu: balioa eremura pasatzen da, zerrenda ixten da eta irakurgailuak balioa berresten du?
  5. Esc: zerrenda ixten da idatzitakoa ezabatu gabe?
  6. iOSen VoiceOverrekin: iradokizunetara irits zaitezke irristatuz, eta bat aukeratu ukitu bikoitzarekin?

Ohiko akatsa

Konbinazio-koadro bat ontzat ematea «gezi-teklek nabarmendua mugitzen dutelako». Behera gezia sakatzean irakurgailuak ezer esaten ez badu, pertsona itsuak ez daki zer aukera dagoen aktibo: 4.1.2 Izena, funtzioa eta balioa irizpidearen akatsa da. Egiaztatu ahots-ikustailean sakatze bakoitzak iragarpen bat sortzen duela eta iragarpen hori pantailan nabarmendutakoarekin bat datorrela.

Elkarrizketa-koadroak: irakurgailuak bakarrik agerian uzten duena

Teklatuarekin, dagoeneko egiaztatuko zenuen fokua elkarrizketa-koadroaren barruan harrapatuta geratzen dela eta Esc teklak ixten duela. Irakurgailuarekin, gehitu lau egiaztapen:

  • Irekitzean: iragartzen da elkarrizketa-koadro bat dela eta bere izenburua? Izena, normalean, elkarrizketa-koadroaren izenburuari seinalatzen dion aria-labelledby-tik dator.
  • Arakatze-moduan: elkarrizketa-koadrotik irten zaitezke Behera geziarekin edo H teklarekin, eta hondoko edukia irakurtzen amaitu? showModal() bidez irekitako <dialog> elementuarekin, orriaren gainerakoa geldo geratzen da; role="dialog"-ekin, aria-modal-en, inert-en eta konbinazio bakoitzaren euskarriaren mende dago, eta horregatik probatzen da oinarrizko lerroko guztietan.
  • Ixtean: fokua ireki zuen botoira itzultzen da, edo galdu egiten da eta irakurgailua orriaren hasieratik irakurtzen hasten da?
  • Mugikorrean: VoiceOverrek edo TalkBackek atzeko edukirantz irristatzen uzten dute?

Akatsak, normalean, 2.4.3 Fokuaren ordena irizpidean (ihes egiten duen edo itzultzen ez den fokua) eta 4.1.2 Izena, funtzioa eta balioa irizpidean (rolik edo izenik gabeko elkarrizketa-koadroa) erregistratzen dira; teklatuarekin ezin bada irten, 2.1.2 Teklatu-fokuarentzako tranparik ez irizpidean.

Kasu klasiko bat: webgunearen nabigazioa role="menu" rolarekin

menu eta menubar rolak aplikazio-menuetarako pentsatuta daude, mahaigaineko programa batenak bezalakoetarako. Webgune baten nabigazio nagusiari aplikatzen zaizkionean, irakurgailuak «menu-barra» eta «menuko elementua» iragartzen ditu, formulario modura pasatu ohi da, eta erabiltzaileak gezi-teklekin mugitzea espero du. Script-ak teklatu-eredu hori inplementatzen ez badu, esperientzia hautsi egiten da: gezi-teklek ez dute ezer egiten, eta portaerak iragarritakoaren kontra egiten du. Webgune baten nabigaziorako, APGk esteka arruntak dituzten zabaltzeko botoien eredua gomendatzen du.

Adibidea

Lineako banka. «Nire produktuak» menuak role="menubar" du. NVDAk «menu-barra, Nire produktuak, azpimenua» iragartzen du. Irekitzeko Behera gezia sakatzean ez da ezer gertatzen; Sartu teklarekin zabaldu egiten da, baina fokua botoian geratzen da, eta aukerak Tab teklarekin bakarrik iristen dira, irakurgailuak azpimenua irekita dagoela adierazi gabe. Zeregina Tab teklarekin osa daitekeenez, ez da 2.1.1en akatsa; bai, ordea, 4.1.2rena, erakutsitako rola eta egoera ez datozelako bat benetako portaerarekin. Gomendioa: ARIA menua zabaltzeko botoiak eta aria-expanded dituen nabigazio-ereduarekin ordeztea.

Txostenerako irizpide praktikoa: oinarrizko lerroko konbinazio batean osagaia ezin bada erabili, akatsa da (2.1.1 edo 4.1.2, kausaren arabera). Erabil badaiteke baina iragartzen duenaren kontra egiten badu, erregistratu bere irizpidearekin, erakutsitako rola edo egoera okerrak direnean, eta gehitu beti eredu egokiaren gomendioa.

Probatu zuk zeuk

Ireki APGko fitxen adibidea W3Cren ereduen katalogoan, NVDA aktibo dagoela. Ibili haren barruan Tab teklarekin eta gezi-teklekin, eta gero arakatze-moduan Sartu teklarekin. Kopiatu ahots-ikustailetik iragartzen dena. Ondoren, errepikatu proba egunero erabiltzen duzun webgune bateko fitxekin, eta alderatu bi irteerak: zer falta da bigarrenean?

Laburpena

  • Ebaluatu osagai bakoitza metodo berarekin: identifikatu eredua bere funtzioaren arabera, idatzi espero den kontratua, eta probatu teklatuarekin, irakurgailuarekin bi moduetan eta mugikorrean.
  • APGk espero den portaera deskribatzen du; ez da derrigorrezkoa, baina deklaratutako ARIA rol batek bete beharreko tekla eta iragarpen batzuk agintzen ditu.
  • Konbinazio-koadroetan, egiaztatu ahots-ikustailearekin aukera aktiboa sakatze bakoitzean iragartzen dela; bestela, 4.1.2ren akatsa da.
  • Elkarrizketa-koadroetan, egiaztatu rola eta izenburua iragartzen direla, hondoa ez dela irisgarria arakatze-moduan eta fokua abiarazlera itzultzen dela.
  • role="menu" webgunearen nabigazioan arazo-iturri ohikoa da: gomendatu zabaltzeko botoien eredua.

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 €)