Addaw, joan hasierara Egin dohaintza

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

Osagai konposatuak: gezi-teklekin nabigatzea, roving tabindex eta aria-activedescendant

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

Orain arte, elementu interaktibo bakoitza Tab geldialdi bat bezala landu dugu. Ondo funtzionatzen du eduki-orri batean, baina ez 12 botoiko tresna-barra batean, 31 eguneko egutegi batean edo 200 udalerriko zerrenda batean: elementu bakoitza geldialdi bat bada, osagaia zeharkatzeak dozenaka sakatze eskatzen ditu, eta kommutadore bat erabiltzen duenak minutuak behar ditu. Mahaigaineko aplikazioek duela hamarkada batzuk konpondu zuten hori, W3Cren ARIA egiletza-praktiken gidak (APG (leiho berri batean irekitzen da)) webgunerako jasotzen duen konbentzio batekin: Tab teklarekin osagaian sartu eta ateratzen zara, eta gezi-teklekin barruan mugitzen zara. Ikasgai honek konbentzio hori eta hura inplementatzeko bi teknikak azaltzen ditu: roving tabindex eta aria-activedescendant. Eredu zehatzak (menuak, fitxak, karruselak) osagai interaktiboei buruzko ikastaroan ikusiko dituzu; hemen guztiek partekatzen duten mekanismoa ikasiko duzu.

Konbentzioa: Tab osagaien artean, gezi-teklak barruan

Osagai konposatu bat unitate gisa jokatzen duten hainbat elementuz osatutako kontrol bat da: tresna-barra bat, aukera-zerrenda bat, aukera-botoi talde bat, fitxa-zerrenda bat, datu-sare bat edo zuhaitz bat. Arau orokorrak hauek dira:

  • Osagai osoa geldialdi bakarra da Tab sekuentzian.
  • Barruan, gezi-teklek fokua mugitzen dute osagaiaren orientazioaren arabera; Hasiera eta Amaiera teklek lehen eta azken elementura eramaten dute.
  • Zerrenda eta zuhaitz luzeetan, letra bat idazteak letra horrekin hasten den hurrengo elementura eramaten du. Tekla bakarreko laster-tekla bat da, baina 2.1.4 Karaktere bakarreko laster-teklak betetzen du, osagaiak fokua duenean soilik dagoelako aktibo, lehen ikasgaian ikusi genuen bezala.
  • Tab teklarekin irten eta itzultzean, fokuak azken elementu aktiboan edo hautatutako elementuan erori beharko luke, ez beti lehenengoan.

Badakizu dagoeneko osagai konposatu natibo bat zein den: aukera-botoi taldea (name bera duten input type="radio" elementuak). Tab teklarekin markatutako aukeran sartzen zara, edo lehenengoan bat ere ez badago; gezi-teklek hautapena aldatzen dute; Tab teklaren beste sakatze batek taldetik ateratzen zaitu. Nabigatzaileak berak egiten du. Osagai pertsonalizatuek portaera hori kode bidez erreproduzitu behar dute.

OsagaiaGezi-teklakOhiko tekla gehigarriak
Tresna-barra (toolbar)Ezkerra eta eskuinaHasiera, Amaiera
Aukera-zerrenda (listbox)Gora eta beheraHasiera, Amaiera, idatzi saltatzeko
Aukera-taldea (radiogroup)Laurak; gainera, aukera markatzen dute—
Sarea edo egutegia (grid)Laurak, gelaxkaz gelaxkaErrenkadako Hasiera/Amaiera; egutegi batean, Page Up/Page Down teklek hilabetez aldatzen dute
Zuhaitza (tree)Gora eta behera; eskuinak zabaltzen du, ezkerrak tolestu edo nodo gurasora igotzen daHasiera, Amaiera, idatzi saltatzeko

1. teknika: roving tabindex

Roving tabindex teknikan («tabindex ibiltaria»), nabigatzailearen fokua benetan mugitzen da elementuen artean. Horietako batek bakarrik du tabindex="0", eta hori da Tab teklarekin sartzean fokua jasotzen duena; gainerakoek tabindex="-1" dute, eta, beraz, Tab tekla ez da haietan gelditzen. Gezi-tekla bat sakatzean, kodeak 0 helmugako elementura pasatzen du, -1 jartzen du aurrekoan eta focus() deitzen du.

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

barra.addEventListener('keydown', (e) => {
  const actual = botones.indexOf(document.activeElement);
  let destino = null;
  if (e.key === 'ArrowRight') destino = (actual + 1) % botones.length;
  if (e.key === 'ArrowLeft') destino = (actual - 1 + botones.length) % botones.length;
  if (e.key === 'Home') destino = 0;
  if (e.key === 'End') destino = botones.length - 1;
  if (destino === null) return; // Tab, Sartu eta Zuriune-barra beren bidean

  e.preventDefault(); // gezi-teklek orria korri ez dezaten
  botones[actual].tabIndex = -1;
  botones[destino].tabIndex = 0;
  botones[destino].focus();
});

Fokua benetakoa denez, gainerako guztiak ahaleginik gabe funtzionatzen du: :focus-visible sasiklaseak adierazlea marrazten du, pantaila-irakurgailuak fokatutako botoia iragartzen du, pantaila-handigailuak jarraitu egiten dio eta, Tab teklarekin irten eta itzultzean, nabigatzailea azken botoi aktibora itzultzen da, tabindex="0" duen bakarra delako. Horregatik da berez gomendatutako teknika.

React, Vue edo Angular erabiltzen duten aplikazioetan, gorde osagaiaren egoeran zer elementu den aktiboa. Osagaia berriro errendatzen bada eta elementu guztiek hasierako tabindex berreskuratzen badute, fokua beti lehenengora itzultzen da, edo, okerrago, bat ere ez da geratzen tabindex="0" balioarekin, eta osagaia sekuentziatik desagertzen da.

2. teknika: aria-activedescendant

Batzuetan, nabigatzailearen fokuak leku batean geratu behar du. Kasu tipikoa combobox bat da (iradokizun-zerrenda duen testu-eremu bat): gezi-teklarekin jaistean fokua aukerara igaroko balitz, pertsonak ezin izango luke idazten jarraitu. Irtenbidea aria-activedescendant da: fokua eremuan geratzen da, eta atributu horrek aukera aktiboaren id-ari seinalatzen dio. Pantaila-irakurgailuak aukera hori iragartzen du fokua izango balu bezala.

<label for="municipio">Udalerria</label>
<input id="municipio" type="text" role="combobox"
       aria-autocomplete="list" aria-expanded="true"
       aria-controls="lista-municipios" aria-activedescendant="mun-2">
<ul id="lista-municipios" role="listbox" aria-label="Udalerriak">
  <li id="mun-1" role="option">Lorca</li>
  <li id="mun-2" role="option" aria-selected="true" class="activa">Lorquí</li>
  <li id="mun-3" role="option">Los Alcázares</li>
</ul>
function activar(opcion) {
  const anterior = lista.querySelector('.activa');
  if (anterior) {
    anterior.classList.remove('activa');
    anterior.removeAttribute('aria-selected');
  }
  opcion.classList.add('activa');
  opcion.setAttribute('aria-selected', 'true');
  campo.setAttribute('aria-activedescendant', opcion.id);
  opcion.scrollIntoView({ block: 'nearest' }); // aukera bistan gera dadin
}

Teknika honekin, nabigatzaileak jada betetzen ez dituen hiru erantzukizun hartzen dituzu:

  1. Adierazle bisuala. :focus ez zaio aukerari aplikatzen, fokua eremuan dagoelako. Nabarmentzea klase batekin marraztu behar duzu, eta nabarmentze horrek 2.4.7 Foku ikusgarria bete behar du eta kontraste nahikoa izan (1.4.11 Testua ez den kontrastea).
  2. Erreferentzia baliozkoa. id-ak DOMean egon behar du eta osagaiarena izan: fokua duen elementuaren ondorengo bat, edo, combobox batean, horrek aria-controls bidez kontrolatzen duen zerrenda. Aukera ezabatzen bada (ikusgai dagoena soilik margotzen duten zerrenda birtualizatuak), irakurgailua iragartzeko ezer gabe geratzen da.
  3. Korritzea. Zerrendak korritze-barra badu, aukera aktiboak ikusgai geratu behar du; horregatik dago scrollIntoView.

Zein aukeratu?

AlderdiaRoving tabindexaria-activedescendant
Non dagoen nabigatzailearen fokuaElementu aktiboanEdukiontzian edo testu-eremuan
Adierazle bisuala:focus-visible sasiklaseak ematen duZuk marrazten duzu klase batekin
BateragarritasunaZabalena: benetako fokua daOna oro har, irakurgailu eta nabigatzaileen konbinazioen artean desberdintasun gehiagorekin
Erabilera tipikoakTresna-barrak, fitxak, sareak, zuhaitzak, menuakTestu-eremua duen combobox-a, fokua mugitu behar ez den zerrendak
Arrisku nagusiatabindex balioak eguneratzea ahazteaExistitzen ez diren id-etarako erreferentziak eta adierazlerik eza

Ohiko akatsa

Arazo beraren hiru aldaera:

  • Osagaiaren elementu bakoitzean tabindex="0" jartzea: 31 geldialdiko egutegi bat edo 12koa den barra bat. Teknikoki erabil daiteke, baina nekagarria da.
  • Gezi-teklak e.preventDefault() gabe inplementatzea: fokua aukeraz aldatzen da eta, aldi berean, orria korritu egiten da.
  • Webguneko nabigazio-menua, esteka-zerrenda soil bat dena, role="menu" eta gezi-teklak dituen osagai bihurtzea. Iristen denak esteketan tabulatzea espero du; irakurgailuak aplikazio-menu bat iragartzen du eta arauak aldatzen ditu. Nabigazio nagusirako nahikoa dira estekak eta zabaltzeko botoiak.

Probatu zuk zeuk

Ireki APGko Developing a Keyboard Interface orria, eta, bertatik, Toolbar ereduaren adibidea. Sartu Tab teklarekin, mugitu gezi-teklekin, irten Tab teklarekin eta itzuli Maius+Tab teklekin. Zenbatu barra zeharkatzeko behar dituzun Tab geldialdiak, eta egiaztatu zer botoitan erortzen zaren itzultzean.

Nola egiaztatu

  • Zenbatu geldialdiak: osagai konposatu bakoitzak Tab geldialdi bakarra izan behar du.
  • Barruan, probatu gezi-tekla guztiak, Hasiera eta Amaiera, eta egiaztatu orria ez dela aldi berean korritzen.
  • Irten eta itzuli: fokuak elementu aktiboan edo hautatuan erori behar du.
  • aria-activedescendant erabiltzen bada, egiaztatu ikuskatzailean atributua sakatze bakoitzean aldatzen dela, id-a badagoela eta nabarmentzea ikusten dela.
  • Egiaztatu pantaila-irakurgailu batekin mugimendu bakoitza iragartzen dela (auditoria-mailan sakon landuko duzu).

Funtsezko puntua

Osagai konposatu bat Tab geldialdi bat da, eta gezi-teklekin zeharkatzen da. Erabili roving tabindex ahal duzun guztietan, fokua benetakoa delako; gorde aria-activedescendant fokuak eremu batean geratu behar duenerako, eta, orduan, marraztu zuk adierazlea.

Laburpena

  • Tab teklarekin osagaian sartu eta ateratzen zara; gezi-teklekin, Hasiera eta Amaiera teklekin barruan mugitzen zara; letra bat idazteak elementu batera salta dezake.
  • Roving tabindex: elementu bakar bat tabindex="0" balioarekin, gainerakoak -1 balioarekin, eta focus() mugimendu bakoitzean.
  • aria-activedescendant: fokua edukiontzian edo eremuan geratzen da, eta atributuak aukera aktiboaren id-ari seinalatzen dio; adierazle bisuala eta korritzea zure kontua dira.
  • Gogoratu azken posizioa irten eta itzultzean, eta erabili preventDefault() kudeatzen dituzun gezi-teklekin.
  • Ez bihurtu osagai konposatu esteka-zerrenda bat dena.

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