Addaw, joan hasierara Egin dohaintza

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

Widget konposatuak: roving tabindex eta aria-activedescendant

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

Tresna-barrak, fitxak, menuak, aukera-zerrendak, zuhaitzak eta saretak oso osagai desberdinak dirudite, baina teklatu-kontratu bera dute: osagai osoa geldiune bakarra da Tab teklarentzat, eta, behin barruan, gezi-teklekin nabigatzen da. APGk widget konposatu deitzen die kontrol horiei (bat bezala jokatzen duten hainbat elementu interaktibok osatutako osagaiak), eta haien fokua kudeatzeko bi teknika deskribatzen ditu: roving tabindex eta aria-activedescendant. «Botoiak, estekak eta kontrol pertsonalizatuak» ikasgaian kontrol isolatu bat berreraikitzeko zerrenda ikusi ondoren, hemen taldekatutako kontrolen mekanika ikasiko duzu, ikastaroaren gainerakoan erabiliko duzuna.

Zergatik tabulazio-geldiune bakarra

Editore bateko hamabi formatu-botoietako bakoitza Tab teklaren geldiune bat bada, hamabi aldiz sakatu behar da testu-eremura iristeko. Mahaigaineko sistema eragileek duela hamarkada batzuk konpondu zuten hori, teklatuaren eta pantaila-irakurgailuen erabiltzaileek ondo ezagutzen duten konbentzio batekin: Tab teklak osagaien artean jauzi egiten du; gezi-teklek osagai bakoitzaren barruan mugitzen dute. Edukiontziaren funtzioak («tresna-barra», «fitxa-zerrenda», «zuhaitza») pantaila-irakurgailuari eta pertsonari jakinarazten die konbentzio hori indarrean dagoela.

Jatorrizko HTMLak dagoeneko egiten du hori name bera partekatzen duten aukera-botoiekin (<input type="radio">): geldiune bakarra eta gezi-teklak aldatzeko. ARIA bidezko widget konposatu batek portaera hori eskuz erreproduzitzen du. Tartean dauden irizpideak hauek dira: 2.1.1 Teklatua (dena teklatuarekin egin ahal izan behar da), 2.4.3 Fokuaren ordena (ibilbideak logikoa izan behar du) eta 4.1.2 Izena, funtzioa eta balioa (funtzioa, izena eta egoera erakutsita).

APG (leiho berri batean irekitzen da) patroiaEdukiontziaren funtzioaErabiltzen dituen gezi-teklakOhiko teknika
Tresna-barratoolbarEzkerrekoa eta eskuinekoaRoving tabindex
FitxaktablistEzkerrekoa eta eskuinekoa (gorakoa eta beherakoa, bertikala bada)Roving tabindex
Menua eta menu-barramenu, menubarGorakoa eta beherakoa; ezkerrekoa eta eskuinekoa barranBietako edozein
Aukera-zerrendalistboxGorakoa eta beherakoaBietako edozein
Comboboxcombobox, listbox batekinGorakoa eta beherakoaaria-activedescendant
Zuhaitza eta saretatree, grid, treegridLaurakBietako edozein

1. teknika: roving tabindex

Roving tabindex-ean («tabindex ibiltaria»), DOMaren fokua benetan mugitzen da elementu batetik bestera. Taldeko elementu batek bakarrik du tabindex="0"; gainerako guztiek tabindex="-1" dute, eta, horrela, script bidez fokagarriak izaten jarraitzen dute, baina nabigatzaileak saltatu egiten ditu tabulatzean. Pertsonak gezi-tekla bat sakatzen duenean, zure kodeak -1 jartzen du uneko elementuan eta 0 helmugakoan, eta focus() deitzen du azken horren gainean.

<div role="toolbar" aria-label="Testuaren formatua">
  <button type="button" aria-pressed="false" tabindex="0">Lodia</button>
  <button type="button" aria-pressed="false" tabindex="-1">Etzana</button>
  <button type="button" aria-pressed="false" tabindex="-1">Azpimarratua</button>
</div>
const barra = document.querySelector('[role="toolbar"]');
const botones = [...barra.querySelectorAll('button')];

function mover(destino) {
  botones.forEach((b) => b.tabIndex = (b === destino) ? 0 : -1);
  destino.focus();
}

barra.addEventListener('keydown', (e) => {
  const i = botones.indexOf(document.activeElement);
  if (i === -1) return;
  const n = botones.length;
  const destinos = {
    ArrowRight: botones[(i + 1) % n],
    ArrowLeft: botones[(i - 1 + n) % n],
    Home: botones[0],
    End: botones[n - 1]
  };
  if (!destinos[e.key]) return;
  e.preventDefault();
  mover(destinos[e.key]);
});

barra.addEventListener('click', (e) => {
  const b = e.target.closest('button');
  if (b) mover(b);
});

Hiru xehetasunek dute garrantzia. Lehenik, tabindex="0" bisitatutako azken elementuan geratzen da: pertsona Tab teklarekin irteten bada eta Maius+Tab konbinazioarekin itzultzen bada, utzi zuen tokian lurreratzen da, eta hori da APGk patroi gehienetan gomendatzen duena. Bigarrenik, klik-kudeatzaileak egoera sinkronizatzen du sagua erabiltzen denean; hura gabe, Tab teklaren geldiunea pertsonak gogoratzen ez duen botoi batean geratzen da. Hirugarrenik, preventDefault() metodoak saihesten du gezi-teklek orria mugitzea barran nabigatzen den bitartean.

Abantaila handia: nabigatzaileak fokuratutako elementua ikusgai jartzen jarraitzen du, :focus-visible aplikatzen du eta foku-gertaera arrunt bat bidaltzen die pantaila-irakurgailuei.

2. teknika: aria-activedescendant

aria-activedescendant erabiliz, DOMaren fokua ez da mugitzen: edukiontzian geratzen da (edo testu-eremuan, combobox batean), eta atributu batek adierazten du haren elementuetatik zein dagoen aktibo. Pantaila-irakurgailuak elementu hori iragartzen du fokua izango balu bezala. Zure kodeak, gezi-tekla bat sakatzean, atributuaren balioa aldatzen du soilik.

<p id="prov-t">Bizilekuko probintzia</p>
<ul role="listbox" tabindex="0" aria-labelledby="prov-t"
    aria-activedescendant="op-murcia">
  <li role="option" id="op-malaga" aria-selected="false">Malaga</li>
  <li role="option" id="op-murcia" aria-selected="true" class="activa">Murtzia</li>
  <li role="option" id="op-navarra" aria-selected="false">Nafarroa</li>
</ul>

Horren truke, nabigatzaileak jada betetzen ez dituen hiru erantzukizun hartzen dituzu:

  1. Adierazle bisuala. :focus-visible edukiontziari aplikatzen zaio, ez aukera aktiboari. Zuk margotu behar duzu aukera aktiboa (klase batekin edo [aria-selected="true"] hautatzailearekin), 2.4.7 Foku ikusgarria betetzen duen eta gutxienez 3:1eko kontrastea duen adierazle batekin (1.4.11 Testua ez den kontrastea).
  2. Korritzea. Zerrendak korritze-barra badu, aukera aktiboa ikuspegitik kanpo gera daiteke. Deitu scrollIntoView({ block: 'nearest' }) haren gainean aldaketa bakoitzean; bestela, ez duzu 2.4.11 Fokua ez ezkutatzea (gutxienekoa) beteko.
  3. Erreferentzia baliozkoa. id horrek existitu egin behar du, elementuak fokua duenaren ondorengoa izan behar du (edo aria-owns bidez hari dagokiona) eta ezin du ezkutatuta egon. Combobox-ean, WAI-ARIA 1.2 (leiho berri batean irekitzen da) espezifikazioak berariaz aurreikusten du eremuak kontrolatzen duen zerrenda gainerakorreko aukera batera seinalatzea.

Ohiko akatsa

<ul role="listbox" tabindex="0" aria-activedescendant="opcion-3">
  <li role="option" tabindex="0">Malaga</li>
  <li role="option" tabindex="0">Murtzia</li>
  <li role="option" tabindex="0">Nafarroa</li>
</ul>

Hiru akats aldi berean: aukerek ez dute id-rik, eta, beraz, aria-activedescendant atributuak existitzen ez den elementu batera seinalatzen du, eta irakurgailuak ez du ezer iragartzen gezi-teklak sakatzean; aukera bakoitzak tabindex="0" du, eta, horrela, zerrenda Tab teklaren lau geldiune bihurtzen da; eta bi teknikak nahasten dira. Aukeratu bat eta aplikatu osorik.

Zein aukeratu

Bietako bat ere ez da bestea baino «irisgarriagoa»; bakoitza egoera desberdinetan egokitzen da. Roving tabindex da aukera lehenetsia elementuak benetako kontrolak direnean (botoiak, estekak, fitxak, menu-elementuak), nabigatzaileak kudeatzen baititu fokua, korritzea eta adierazlea. aria-activedescendant ezinbestekoa da fokuak testu-eremu batean geratu behar duenean zerrenda bat zeharkatzen den bitartean, «Combobox, listbox eta osatze automatikoa» ikasgaian ikusiko duzun combobox-ean bezala: fokua aukerara eramango bazenu, pertsonak ezingo luke idazten jarraitu. Korritu ahala errendatzen diren zerrenda luzeetan ere erabilgarria da. Pantaila-irakurgailuetan duen euskarria hobetu egin da, baina probatu zure publikoaren konbinazioetan, batez ere mugikorrean.

Infografia · Alderaketa

Roving tabindex eta aria-activedescendant alderatuta

Widget konposatu baten barruko fokua kudeatzeko bi modu

Roving tabindex

  • DOMaren fokua elementu bakoitzera mugitzen da focus() bidez
  • Elementu aktiboak bakarrik du tabindex=0; gainerakoek, -1
  • Nabigatzaileak ikuspegia mugitzen du eta :focus-visible aplikatzen du
  • Lehenetsia: botoiak, fitxak eta menu-elementuak

aria-activedescendant

  • DOMaren fokua edukiontzian edo eremuan geratzen da
  • Atributuak elementu aktiboaren id-ra seinalatzen du
  • Zuk margotzen duzu adierazlea eta zuk mugitzen duzu zerrenda
  • Ezinbestekoa combobox-ean: idazten jarraitu daiteke
ADDAW · Irisgarritasun-ikastaroak
Irakurri infografia testu gisa

Widget konposatu baten barruko fokua kudeatzeko APGren bi tekniken alderaketa, bi zutabetan. Ezkerreko zutabea, roving tabindex: DOMaren fokua elementu bakoitzera mugitzen da focus() bidez; elementu aktiboak bakarrik du 0 tabindex-a, eta gainerakoek -1; nabigatzaileak ikuspegia mugitzen du eta :focus-visible aplikatzen du; botoi, fitxa eta menu-elementuetarako aukera lehenetsia da. Eskuineko zutabea, aria-activedescendant: DOMaren fokua edukiontzian edo testu-eremuan geratzen da; atributuak elementu aktiboaren id-ra seinalatzen du; garatzaileak margotzen du adierazle bisuala eta mugitzen du zerrenda; ezinbestekoa da combobox-ean, iradokizunak zeharkatzen diren bitartean idazten jarraitzeko aukera ematen duelako.

Aldea markatzen duten xehetasunak

  • Zikloa edo muga. Fitxetan eta menuetan ohikoa da azkenetik lehenengora pasatzea; zerrendetan, zuhaitzetan eta saretetan, muturrean gelditzea. Arau bat patroi bakoitzeko, produktu osoan.
  • Hasiera, Amaiera eta aurreidazketa. Hasiera eta Amaiera teklek lehen eta azken elementura eramaten dute. Aurreidazketa (type-ahead: letra bat idaztea letra horrekin hasten den lehen elementura jauzi egiteko) aukerakoa da patroi askotan, baina APGk aukera-zerrenda guztietan gomendatzen du, batez ere zazpi elementu baino gehiago dituztenetan.
  • Elementu desgaituak. Widget konposatuetatik kanpo, espero izatekoa da kontrol desgaitu batek fokua ez jasotzea. Menu edo zerrenda baten barruan, APGk adierazten du ohikoa dela gezi-teklekin iristeko modukoa izaten jarraitzea (aria-disabled="true" atributuarekin), pertsonak jakin dezan aukera badagoela, erabilgarri ez egon arren.
  • Desagertzen diren elementuak. Elementu aktiboa ezabatzen bada (etiketa bat ezabatzea iragazki-zerrenda batetik), eraman fokua hurbilen dagoen aldameneko elementura. <body> elementuan erortzen den foku batek orriaren hasieratik tabulatzen hastera behartzen du.
  • Orientazioa. Fitxa-zerrenda bertikal bat aria-orientation="vertical" atributuarekin deklaratzen da, eta gora eta behera gezi-teklei erantzuten die.
  • Pantaila-irakurgailuen modua. Windowsen, NVDA eta JAWS normalean foku-modura (edo formulario-modura) pasatzen dira funtzio horietako gehienetan sartzean, eta handik aurrera gezi-teklak zure kodera iristen dira. Horregatik, teklatua inplementatu gabeko widget konposatu baten funtzio batek harrapatuta uzten du pertsona: irakurgailuak utzi egin dio gezi-teklak irakurtzeko erabiltzeari, eta zure osagaiak ere ez ditu erabiltzen.

Funtsezko puntua

Widget konposatu bat bi zatiko promesa bat da: funtzioak «hemen gezi-teklekin nabigatzen da» iragartzen du, eta zure JavaScriptek bete egin behar du. Teklatu-portaera osoa inplementatuko ez baduzu, ez jarri funtzioa; botoi arrunten talde bat, bakoitza bere Tab geldiunearekin, ez da hain eraginkorra, baina funtzionatzen du.

Nola egiaztatu

  • Zeharkatu orria Tab teklarekin: widget konposatu bakoitzak geldiune bakarra izan behar du, eta irten eta itzultzean bisitatutako azken elementuan (edo hautatutakoan) lurreratu behar duzu.
  • Osagaiaren barruan, probatu gezi-tekla guztiak, Hasiera eta Amaiera, eta egiaztatu adierazle bisualak beti laguntzen diola elementu aktiboari.
  • Garapen-tresnetan, begiratu nola aldatzen diren tabindex edo aria-activedescendant, eta egiaztatu erreferentziatutako id hori existitzen dela eta izena duela.
  • Pantaila-irakurgailu batekin, gezi-tekla bakoitzak iragarpen bat sortu behar du elementuaren izenarekin, funtzioarekin eta posizioarekin («Etzana, botoia, sakatu gabe»).
  • Korritze-barra duten zerrendetan, jaitsi amaieraraino gezi-teklekin: aukera aktiboak ez du inoiz ezkutatuta geratu behar.

Probatu zuk zeuk

Ireki APGren tresna-barraren adibidea. Sartu Tab teklarekin, mugitu gezi-teklekin, irten Tab teklarekin eta itzuli Maius+Tab konbinazioarekin: begiratu non lurreratzen zaren. Ondoren, ireki elementu-ikuskatzailea eta begiratu nola aldatzen den botoien tabindex atributua sakatze bakoitzean.

Sakontzeko: APG: teklatu-interfazea garatzea.

Laburpena

  • Widget konposatu bat Tab teklaren geldiune bakarra da; barruan, gezi-teklekin, Hasiera teklarekin eta Amaiera teklarekin nabigatzen da.
  • Roving tabindex: elementu aktiboak bakarrik du tabindex="0", gainerakoek -1, eta DOMaren fokua focus() bidez mugitzen da.
  • aria-activedescendant: fokua edukiontzian edo eremuan geratzen da; zuk margotzen duzu adierazlea, zuk mugitzen duzu zerrenda eta zuk mantentzen duzu id baliozko bat.
  • Roving tabindex lehenetsita; aria-activedescendant, idazten jarraitu behar denean, combobox-ean bezala.
  • Teklatu-portaera osoa inplementatzen ez baduzu, ez erabili widget konposatuaren funtzioa.

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.