Addaw, joan hasierara Egin dohaintza

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

Rolak, egoerak eta propietateak; izen eta deskribapen irisgarriak (4.1.2)

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

4.1.2 Izena, funtzioa eta balioa (A) irizpidea edozein osagairen irisgarritasunaren muina da: interfazeko elementu orotan, izena eta funtzioa (rola) programa bidez zehaztu ahal izan behar dira; pertsonak alda ditzakeen egoerak, propietateak eta balioak programa bidez irakurri eta aldatu ahal izan behar dira; eta laguntza-teknologiei aldaketen berri eman behar zaie. ARIA da hori guztia adierazteko erabiltzen dugun hiztegia, HTMLk ez duenean nahikoa ematen. Ikasgai honetan hiztegi hori ordenatuko dugu.

Rolak: zer den elementua

Rolak «zer da hau?» galderari erantzuten dio. ARIA 1.2-k hamarnaka rol definitzen ditu, kategoriatan multzokatuta:

  • Widget-rolak: button, checkbox, radio, switch, slider, tab, menuitem, option, combobox, textbox, link…
  • Rol konposatuak, widgetak dituztenak: tablist, menu, listbox, radiogroup, tree, grid.
  • Egitura-rolak: heading (aria-level-ekin), list, listitem, table, row, cell, img, group, presentation/none.
  • Landmark-rolak: banner, navigation, main, complementary, contentinfo, search, form, region.
  • Eskualde biziko rolak: alert, status, log, timer, marquee.
  • Leiho-rolak: dialog, alertdialog.

Ia guztiek dute rol inplizitua duen HTML baliokide bat (<button> button da, <h2> 2. mailako heading da, <nav> navigation da). Rol esplizitua elementu natibo baliokidearen gainean idaztea (<button role="button">) erredundantea eta alferrikakoa da; tresnek abisu gisa markatzen dute.

Rol batzuek egitura jakin bat eskatzen dute: tab batek tablist baten barruan egon behar du; option batek, listbox baten barruan; row batek, table edo grid baten barruan; menuitem batek, menu edo menubar baten barruan. Hierarkia hori hausten baduzu, irakurgailuak ez daki osagaia nola interpretatu.

Egoerak eta propietateak: nola dagoen eta zerekin lotzen den

aria-* atributuak bi taldetan banatzen dira. Egoerak elkarrekintzarekin aldatzen dira, eta JavaScriptekin eguneratu behar dira:

EgoeraEsanahiaNon erabiltzen den
aria-expandedZabalduta edo tolestutaAkordeoi-botoiak, menuak, combobox-ak
aria-pressedSakatuta edo ez (txandakatzailea)Txandakatze-botoiak (lodia, gogokoa)
aria-checkedMarkatuta, markatu gabe edo mistoaKontrol-lauki eta aukera-botoi pertsonalizatuak, switch
aria-selectedHautatutaFitxak, aukerak, sareta-errenkadak
aria-disabledDesgaituta, baina hautemangarriaKontrol pertsonalizatuak
aria-invalidBalio baliogabeaErrorea duten eremuak
aria-currentMultzo bateko uneko elementuaUneko orriaren esteka, uneko urratsa
aria-busyEguneratzen ari daKargatzen ari diren eskualdeak

Propietateek ezaugarri eta erlazio egonkorragoak deskribatzen dituzte:

  • Izendapena eta deskribapena: aria-label, aria-labelledby, aria-describedby.
  • Erlazioak: aria-controls (zer elementu kontrolatzen duen), aria-owns (DOMetik kanpoko seme-alaba logikoak), aria-activedescendant (zer ondorengok duen foku birtuala).
  • Tartea eta balioa: aria-valuemin, aria-valuemax, aria-valuenow, aria-valuetext, graduatzaile, aurrerapen-barra eta neurgailuetarako.
  • Portaera: aria-haspopup, aria-modal, aria-multiselectable, aria-required, aria-readonly, aria-level, aria-posinset, aria-setsize.
  • Ikusgaitasuna: aria-hidden (WAI-ARIA 1.2 (leiho berri batean irekitzen da)-k, egiaz, egoera gisa sailkatzen duena).

Adibidea

Botoi natibo batekin eraikitako «Jakinarazpenak» etengailu bat:

<button type="button" role="switch" aria-checked="false" id="notif">
  Posta bidezko jakinarazpenak
</button>
const sw = document.getElementById('notif');
sw.addEventListener('click', () => {
  const activo = sw.getAttribute('aria-checked') === 'true';
  sw.setAttribute('aria-checked', String(!activo));
});

Irakurgailuak «Posta bidezko jakinarazpenak, etengailua, desaktibatuta» iragartzen du, eta, sakatzean, «aktibatuta». 4.1.2 betetzen da: izena (testua), funtzioa (switch), egoera (aria-checked) eta aldaketaren jakinarazpena (nabigatzaileak abisatzen du atributua aldatzean). Teklatua <button>-ek ematen du. Etengailuaren estilo bisuala CSS bidez marrazten da [aria-checked="true"] abiapuntu hartuta; horrela, egoera bisuala eta programatikoa ez dira inoiz bereizten.

Izen eta deskribapen irisgarriak

Gogora dezagun HTML ikastarotik izena kalkulatzeko ordena: aria-labelledby, aria-label, iturri natiboa, title. Orain ñabardura garrantzitsuak gehituko ditugu:

  • aria-labelledby-k id bat baino gehiago erreferentzia ditzake, eta ordenan kateatzen ditu, elementua bera barne. Erabilgarria da izenak osatzeko: aria-labelledby="boton-leer titulo-tarjeta" atributuak «Irakurri gehiago 2025eko aurrekontuak» ematen du; id-en ordena alderantzikatzen baduzu, izena «2025eko aurrekontuak Irakurri gehiago» izango da.
  • Erreferentziatutako elementua hidden edo aria-hidden bidez ezkutatuta egon daiteke; haren testua berdin erabiltzen da izenerako. Horri esker, izenerako soilik diren testuak erabil daitezke, erakutsi gabe.
  • aria-label eta aria-labelledby ez dabiltza modu fidagarrian rolik gabeko edo rol generikoak dituzten elementuetan (div, span), ezta testu-rol batzuetan ere, hala nola paragraph (p-rena), code edo strong, izena berariaz debekatzen baitute. Rolik gabeko <div> batean aria-label jartzeak ez du ezertarako balio praktikan.
  • Deskribapena (aria-describedby) bigarren mailako informazioa da: irakurgailuak izenaren, rolaren eta egoeraren ondoren iragartzen du, askotan etenaldi baten ondoren, eta erabiltzaile batzuek desaktibatu egiten dute. Ez jarri inoiz deskribapenean kontrola ulertzeko ezinbestekoa den ezer.
  • Widget-rolek kasu batzuetan bakarrik onartzen dute edukitik ateratako izena (button, link, tab, menuitem, option, checkbox…). textbox, combobox edo slider batek aria-label, aria-labelledby edo <label> bat behar du.

Ohiko akatsa

<div aria-label="Bilaketaren emaitzak">…</div>
<span aria-label="Prezioa">189 €</span>

Lehenengo kasuan, aria-label ez da kontuan hartzen, <div>-ek ez baitu rolik; role="region" (edo <section> bat) behar da. Bigarrenean, nabigatzaile batzuetan izenak edukia ordezten du, eta pertsonak «Prezioa» entzuten du, baina ez «189 €». Testu arrunterako, ez erabili aria-label; idatzi behar den testu ikusgaia.

Aldaketen berri ematea

4.1.2 irizpidearen azken zatiak dio laguntza-teknologiei egoera-aldaketen berri eman behar zaiela. Hori automatikoki gertatzen da fokua duen elementuaren ARIA atributuak edo propietate natiboak (checked, disabled, value) aldatzen dituzunean: nabigatzaileak dagokion irisgarritasun-gertaera sortzen du. Jakinarazten ez dena aldaketa bisual hutsa da: CSS klase bat aldatzea botoi bat «aktibo» gisa margotzeko, aria-pressed ukitu gabe, irakurgailua informaziorik gabe uzten du. Araua erraza da: egoera bisual bakoitzak egoera programatiko bat izan behar du lagun, eta onena da CSSa atributuaren mende egotea ([aria-pressed="true"]) eta ez klase paralelo baten mende.

Funtsezko puntua

Osagai bakoitzerako, egin lau galdera: zer da? (rola), nola du izena? (izena), nola dago? (egoera edo balioa) eta irakurgailua jabetzen da aldatzen denean? Laurek kodean erantzuna badute, 4.1.2 betetzen duzu.

Laburpena

  • Rolak adierazten du zer den elementua; ia beti HTML natiboak ematen du, eta rol esplizituek ARIAk eskatzen duen hierarkia errespetatu behar dute.
  • Egoerak (aria-expanded, aria-checked, aria-selected, aria-current…) elkarrekintzarekin aldatzen dira eta JavaScriptekin eguneratu behar dira; propietateek erlazioak eta tarteak deskribatzen dituzte.
  • aria-label eta aria-labelledby rola duten elementuetan bakarrik dabiltza; ez erabili testu arruntean.
  • Deskribapena bigarren mailakoa da; ezinbestekoa izenean edo edukian doa.
  • Egin CSSa ARIA atributuaren mende egon dadin, egoera bisuala eta programatikoa inoiz bereiz ez daitezen.

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.