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) patroia | Edukiontziaren funtzioa | Erabiltzen dituen gezi-teklak | Ohiko teknika |
|---|---|---|---|
| Tresna-barra | toolbar | Ezkerrekoa eta eskuinekoa | Roving tabindex |
| Fitxak | tablist | Ezkerrekoa eta eskuinekoa (gorakoa eta beherakoa, bertikala bada) | Roving tabindex |
| Menua eta menu-barra | menu, menubar | Gorakoa eta beherakoa; ezkerrekoa eta eskuinekoa barran | Bietako edozein |
| Aukera-zerrenda | listbox | Gorakoa eta beherakoa | Bietako edozein |
| Combobox | combobox, listbox batekin | Gorakoa eta beherakoa | aria-activedescendant |
| Zuhaitza eta sareta | tree, grid, treegrid | Laurak | Bietako 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:
- Adierazle bisuala.
:focus-visibleedukiontziari 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). - 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. - Erreferentzia baliozkoa.
idhorrek existitu egin behar du, elementuak fokua duenaren ondorengoa izan behar du (edoaria-ownsbidez 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
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
tabindexedoaria-activedescendant, eta egiaztatu erreferentziatutakoidhori 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 fokuafocus()bidez mugitzen da. aria-activedescendant: fokua edukiontzian edo eremuan geratzen da; zuk margotzen duzu adierazlea, zuk mugitzen duzu zerrenda eta zuk mantentzen duzuidbaliozko 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.