Addaw, joan hasierara Egin dohaintza

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

Elementuen arteko erlazioak: id bidezko erreferentziak eta erlazio-propietateak

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

HTMLk erlazio asko habiaratzearen bidez adierazten ditu (<li> bat hura biltzen duen zerrendarena da) edo atributu natiboekin (<label for>, headers tauletan). Erlazioa horrela adierazi ezin denean —laguntza-testua eremutik urrun dagoelako, iradokizunen zerrenda dokumentuaren amaieran margotzen delako edo nabarmentzea zerrenda batean zehar mugitzen delako benetako fokua mugitu gabe—, ARIAk erlazio-propietateak eskaintzen ditu. Rolei eta egoerei buruzko ikasgaian ikusi zenuen nola osatzen den izen bat aria-labelledby-rekin; hemen erlazio multzoa errepasatuko dugu, baita erlazio horiek oinarri dituzten id bidezko erreferentziek nola funtzionatzen duten eta bakoitzak zer benetako euskarri duen ere.

Nola funtzionatzen duten id bidezko erreferentziek

Erlazio-propietate ia guztiek beste elementu batzuetara seinalatzen dute, haien id-aren bidez. Batzuek identifikatzaile bakarra onartzen dute (aria-activedescendant, eta ARIA 1.2-n baita aria-errormessage eta aria-details ere), eta beste batzuek zuriunez bereizitako zerrenda bat (aria-labelledby, aria-describedby, aria-controls, aria-owns). Arauak errazak dira, baina etengabe hausten dira:

  • Identifikatzaileak bakarra izan behar du dokumentuan. id bera duten bi elementu badaude, nabigatzaileak horietako bat erabiliko du (normalean lehenengoa), eta emaitza orria zer ordenatan margotu zen araberakoa izango da.
  • Helmugak existitu egin behar du nabigatzaileak erlazioa kalkulatzen duenean. Existitzen ez den id baterako erreferentzia batek ez du errore ikusgairik ematen: besterik gabe, ez dago izenik, ez deskribapenik, ez erlaziorik.
  • Identifikatzaileek maiuskulak eta minuskulak bereizten dituzte: ayuda-DNI eta ayuda-dni desberdinak dira.
  • Erreferentziek ez dute Shadow DOMa zeharkatzen. Shadow root bat duen web-osagai batean (osagai pertsonalizatu baten zuhaitz kapsulatua), barruko aria-labelledby batek ezin dio dokumentu nagusiko id bati seinalatu, ezta alderantziz ere. Web-osagaiekin lan egiten baduzu, izenaren edo deskribapenaren testuak kontrolaren zuhaitz berean egon behar du.
  • Osagai berrerabilgarriek instantzia bakoitzeko identifikatzaileak behar dituzte. Orri berean bi aldiz margotzen den eta id="ayuda" finkoa duen eremu batek bi erlazioak hausten ditu. Sortu identifikatzaile bakarrak (Reacten, adibidez, useId erabiliz).

Ohiko akatsa

<!-- «Laguntza duen eremua» osagaia, bi aldiz erabilia formulario berean -->
<label for="campo">Telefonoa</label>
<input id="campo" aria-describedby="ayuda">
<p id="ayuda">Bederatzi zifra, aurrizkirik gabe</p>

<label for="campo">Helbide elektronikoa</label>
<input id="campo" aria-describedby="ayuda">
<p id="ayuda">Hona bidaliko dizugu egiaztagiria</p>

Bigarren eremua etiketarik gabe geratzen da, eta lehenengoaren laguntza jasotzen du (lehenengoak, bitartean, bi etiketak izan ditzake izen gisa); bigarren etiketa sakatzean, fokuak lehenengo eremura salto egiten du. Bisualki, dena zuzena dirudi. Tresna automatikoek id bikoiztuak hautematen dituzte: bertsio bakoitzean tresna horiek pasatzeari etekin handiena ateratzen dioten akatsetako bat da.

Erlazio-propietateak, banan-banan

PropietateaZertarako balio duenEuskarria eta zuhurtziak
aria-labelledbyIzena beste elementu batzuen testutik abiatuta kalkulatzekoOso ona. Lehentasuna du izenaren beste edozein iturriren gainetik
aria-describedbyDeskribapen bat lotzeko: espero den formatua, laguntza, errore-mezuaOso ona. Testua laututa irakurtzen da, egiturarik gabe
aria-controlsKontrolak zer elementu aldatzen duen adierazteko (botoia eta panela, combobox-a eta zerrenda)Irakurgailu gutxik aprobetxatzen dute (JAWSek kontrolatutako elementura salto egiteko aukera ematen du). Jarri APGk adierazten duenean, baina ez jakinarazi haren bidez ezinbestekoa den ezer
aria-ownsDOMean beste leku batean dauden elementuak seme-alaba gisa adieraztekoDesberdina nabigatzaileen artean. Ia beti hobe da elementua DOMean mugitzea
aria-activedescendantZer ondorengo dagoen aktibo adierazteko, benetako fokua edukiontzian edo eremuan dagoen bitarteanOna APGren ereduetan (combobox, listbox, sareta). Nabarmentze bisuala eta korritzea eskuz kudeatzea eskatzen du
aria-errormessageErrore-mezua eremu bati lotzeko; eremuak aria-invalid="true" badu bakarrik hartzen da kontuanIrregularra. Konbinatu aria-describedby-rekin, edo erabili azken hori bakarrik
aria-detailsInformazio luze eta egituratuarekin lotzeko (ohar bat, iruzkin bat, grafiko baten azalpena)Mugatua. Eskaini, gainera, esteka bat edo testu ikusgai bat
aria-flowtoIrakurketa-ordena alternatibo bat proposatzekoOso mugatua. Ez erabili DOMeko ordena oker bat konpontzeko; zuzendu ordena (1.3.2)

Funtsezko puntua

Euskarri onena duten erlazioak izena eta deskribapena elikatzen dituztenak dira (aria-labelledby eta aria-describedby), eta aria-activedescendant eredu ezagunen barruan. Gainerako guztirako, erlaziorik onena DOMak berak adierazten duena da: elementu zuzena, leku zuzenean eta ordena zuzenean.

aria-activedescendant: mugitzen ez den fokua

Udalerrien bilatzaile autoosatudun batean, pertsonak testu-eremu batean idazten du, eta, gezi-teklekin, iradokizunak zeharkatzen ditu. Benetako fokua ezin da eremutik atera, orduan idazteko gai izateari utziko bailioke. Irtenbidea aria-activedescendant da: eremuak fokua mantentzen du, eta haren atributuak, id-aren bidez, une bakoitzean zer aukera dagoen aktibo adierazten du. Irakurgailuak aukera hori iragartzen du, fokua balu bezala.

<label for="municipio">Udalerria</label>
<input id="municipio" type="text" role="combobox"
       aria-autocomplete="list" aria-expanded="true"
       aria-controls="sugerencias" aria-activedescendant="mun-3">
<ul id="sugerencias" role="listbox" aria-label="Iradokizunak">
  <li id="mun-1" role="option">Cartagena</li>
  <li id="mun-2" role="option">Lorca</li>
  <li id="mun-3" role="option" aria-selected="true">Murtzia</li>
</ul>

Funtziona dezan, kodeak lau betebehar ditu:

  1. aria-activedescendant gezi-tekla bakoitzarekin eguneratzea, eta zerrenda ixten denean hustea (edo kentzea).
  2. Aukera bakoitzari id bakar bat ematea, eta existitzen diren eta fokua duen elementuaren ondorengoak diren elementuei bakarrik seinalatzea, edo, combobox batean, kontrolatzen duen zerrendako aukerei.
  3. Aukera aktiboaren nabarmentzea CSS bidez marraztea, nabigatzaileak ez baitu egiten: hori gabe, 2.4.7 Foku ikusgarria ez da betetzen pantaila ikusten duenarentzat.
  4. Zerrenda korritzea, aukera aktiboa bistan gera dadin.

Alternatiba roving tabindex da (benetako fokua elementuen artean mugitzea, aktiboan tabindex="0" eta gainerakoetan -1 jarrita), N3-C3 ikastaroan ikusi zenuena. Erabili aria-activedescendant fokuak testu-eremu batean geratu behar duenean, eta roving tabindex gainerako kasuetan; eredu osoak N3-C5 ikastaroan garatzen dira.

Posizioa eta tamaina multzoetan

Irakurgailuak «20tik 3. elementua» kalkulatzen du DOMean dauden elementuak zenbatuz. Zerrenda orrikatuta edo birtualizatuta badago (errenkada ikusgaiak bakarrik daude DOMean), zenbaketa hori faltsua da. ARIAk benetako posizioa eta guztizkoa adierazteko aukera ematen du:

  • aria-setsize eta aria-posinset: multzoaren tamaina eta elementuaren posizioa, zerrendetan, aukeretan, fitxetan, zuhaitz-elementuetan edo feed bateko artikuluetan. Guztizkoa ezezaguna bada, ARIA 1.2-k aria-setsize="-1" onartzen du.
  • aria-level: habiaratze-maila zuhaitzetan eta role="heading" bidez eraikitako izenburuetan.
  • aria-rowcount, aria-rowindex, aria-colcount eta aria-colindex: zati bat bakarrik margotzen den taula edo sareta baten benetako errenkadak eta zutabeak.

Adibidea

Egoitza elektroniko bateko izapide-katalogoak 1.250 sarrera ditu, eta 20 kargatzen ditu aldi bakoitzean. Beste informaziorik gabe, irakurgailuak «20tik 1.» iragartzen du hirugarren sortako lehenengo emaitzan. Benetako posizioarekin:

<ul aria-label="Izapideak">
  <li aria-posinset="41" aria-setsize="1250">…</li>
  <li aria-posinset="42" aria-setsize="1250">…</li>
</ul>

Atributu horien euskarria zerrenda soiletan aldatu egiten da irakurgailuen artean; probatu. Eta ez ahaztu testu ikusgai baliokidea («1.250etik 41-60 erakusten»), denei laguntzen baitie.

Deskribapenak: zenbat eta zer

aria-describedby-k euskarri ona izateak ez du esan nahi edozer onartzen duenik. Deskribapena izenaren, rolaren eta egoeraren ondoren irakurtzen da, testu bakar batean laututa: izenbururik gabe, zerrendarik gabe eta esteka erabilgarririk gabe. Horregatik:

  • Mantendu laburra: espero den formatua, murrizketa bat, errore-mezua.
  • Ez seinalatu bloke luzeetara (erabilera-baldintza osoak): osorik irakurriko dira eremuak fokua jasotzen duen bakoitzean, eta pertsonak ezin izango du haietan zehar nabigatu.
  • Ez seinalatu eduki interaktibora: barruan duen esteka testu gisa irakurriko da, baina ezin izango da handik aktibatu.
  • Hainbat zati behar badituzu (laguntza eta errorea), erabili identifikatzaile-zerrenda bat, irakurtzea nahi duzun ordenan: aria-describedby="error-dni ayuda-dni".

Probatu zuk zeuk

Bilatu laguntza-testuak dituen formulario bat (zerbitzu batean alta emateko formularioa, edo egoitza elektroniko bateko eskaera batena). Ikuskatu eremu bat: aria-describedby du?, Irisgarritasuna panelak deskribapen bat erakusten du? Kopiatu identifikatzailea, eta egiaztatu kontsolan zenbat elementuk duten document.querySelectorAll('[id="ayuda-dni"]').length erabiliz, balioa ordeztuta. 0 ematen badu, erreferentzia hautsita dago; 1 baino gehiago ematen badu, bikoiztuta dago.

Kontsultatu propietate bakoitzaren definizio formala espezifikazioan; adibidez, aria-activedescendant WAI-ARIA 1.2-n.

Laburpena

  • ARIA erlazioak id bidezko erreferentzietan oinarritzen dira: bakarrak, existitzen direnak, maiuskula zehatzekin eta Shadow DOMeko zuhaitz beraren barruan.
  • aria-labelledby, aria-describedby eta aria-activedescendant atributuek euskarri ona dute; aria-controls, aria-owns, aria-details, aria-errormessage eta aria-flowto atributuena mugatua edo desberdina da.
  • aria-activedescendant-ek fokua eremuan mantentzen du eta aukera aktiboa adierazten du, baina nabarmentze bisuala eta korritzea zure ardura dira.
  • Zerrenda orrikatu edo birtualizatuetan, aria-setsize eta aria-posinset atributuek (eta errenkada eta zutabeetarako haien baliokideek) benetako posizioa ematen dute.
  • Deskribapenek laburrak izan behar dute, eduki interaktiborik gabe eta nahi den irakurketa-ordenan.

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