Teknika ARIA WCAG 2.2
ARIA16Kontrolei izena ematea aria-labelledby bidez
Izen ofiziala W3Cn: aria-labelledby erabiltzea erabiltzaile-interfazeko kontrolei izena emateko
Laburbilduz
Batzuetan, eremu edo kontrol batek ez du etiketa propiorik, baina ondoan badago zertarako den azaltzen duen testu ikusgarri bat. aria-labelledby erabilita, testu hori kontrolaren izen gisa erabiltzen da. Orriko hainbat testu ere elkartu daitezke izen oso bat osatzeko.
Zergatik da garrantzitsua
Orria ikusten duenak inguruan duenari begiratuta asmatzen du eremu bat zertarako den. Pantaila-irakurgailu batek (pantaila ozenki irakurtzen duen programa) ezin du hori egin: eremuak izen propioa izan behar du.
Izenik gabe, pertsonak «testu-eremua» entzuten du, eta ez daki zer idatzi. aria-labelledby erabilita, besteek ikusten duten testu bera entzuten du.
Nola egiten da
- Ahal duzun guztietan, erabili
<label>: etiketa sakatzean, fokua eremura joaten da.aria-labelledbyerabilita, hori ez da gertatzen. - Erabili
aria-labelledbyetiketa batentzako lekurik ez dagoenean edo izena lehendik dagoen testu batetik datorrenean: izenburu bat, botoi baten testua, taula-gelaxka bat. - Eman
idbakar bat izen gisa erabiliko den testuari. - Gehitu kontrolari
aria-labelledby,idhorrekin. Testu bat baino gehiago badira, jarriid-ak zuriunez bereizita, irakurri behar diren ordenan. - Kontuan izan
aria-labelledby-k lehentasuna duela<label>-en etaaria-label-en gainetik. Konbinatzen badituzu, harena bakarrik irakurtzen da.
Adibide praktikoa
Udal baten webguneko goiburuko bilatzailea. Diseinuz, ez du etiketa ikusgarririk. Eremua azaltzen duen testu bakarra ondoan dagoen «Bilatu» botoiarena da.
Horrela ez: Izenik gabeko bilaketa-eremua
Begiratuta, botoiari esker ulertzen da. Baina eremuak ez du ez etiketarik ez izenik pantaila-irakurgailuarentzat. «Edizioa» edo «testu-eremua» baino ez da entzuten, zertarako den esan gabe. Hori ohartzeko, aktibatu NVDA edo VoiceOver eta iritsi eremura tabuladorearekin.

Erakustaldiak nahita dauka azaltzen den irisgarritasun-akatsa.
Ikusi adibide okerraren kodea
<form role="search" action="#" class="buscador">
<input type="search" id="q" name="q">
<button type="submit" id="btn-buscar">Bilatu</button>
</form>
<style>
.buscador { display: flex; gap: .5em; }
.buscador input { flex: 1; padding: .4em; border: 1px solid #555; }
.buscador button { background: #744E9A; color: #fff; border: 0; padding: .4em 1em; }
.buscador :focus-visible { outline: 3px solid #0B2239; outline-offset: 2px; }
</style>Horrela bai: Izena botoitik aria-labelledby bidez hartzen duen eremua
aria-labelledby="btn-buscar" gehitzen zaio eremuari. Haren izena botoiaren testua bihurtzen da: «Bilatu». Ez dago testua pantailan errepikatu beharrik. Gainera, izena ikusten denarekin bat dator (2.5.3 irizpidea).
Probatu hemen:
Ikusi adibide zuzenaren kodea
<form role="search" action="#" class="buscador">
<input type="search" id="q" name="q" aria-labelledby="btn-buscar">
<button type="submit" id="btn-buscar">Bilatu</button>
</form>
<style>
.buscador { display: flex; gap: .5em; }
.buscador input { flex: 1; padding: .4em; border: 1px solid #555; }
.buscador button { background: #744E9A; color: #fff; border: 0; padding: .4em 1em; }
.buscador :focus-visible { outline: 3px solid #0B2239; outline-offset: 2px; }
</style>Nola egiaztatu
Auditorietako ohiko akatsak
- Existitzen ez den edo errepikatuta dagoen id bat adieraztea. Kontrola izenik gabe edo izen oker batekin geratzen da.
- aria-labelledby funtziorik gabeko div edo span batean erabiltzea. Horietan ez da izena ematen uzten, eta pantaila-irakurgailuek ez diote jaramonik egiten.
- Kontrolaren ondoan ikusten denaz bestelako testu bat adieraztea. Horrela, ez da betetzen 2.5.3 irizpidea (Etiketa izenean).
- aria-labelledby beste label ikusgarri batekin konbinatzea. aria-labelledby-k lehentasuna du eta label-a ordezten du.
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko ARIA16 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
Accessible Rich Internet Applications (WAI-ARIA) onartzen duten teknologiak.
Deskribapena
Teknika honen helburua da laguntza-teknologiek irakur ditzaketen izenak ematea erabiltzaile-interfazeko kontrolei. WAI-ARIAk testu bat atal, marrazki, formulario-elementu, argazki eta abarri lotzeko modu bat eskaintzen du, aria-labelledby propietatearen bidez. Teknika honek aria-labelledby atributua erabiltzen du erabiltzaile-interfazeko kontrol bat (formulario-eremu bat, adibidez) hura etiketatzen duen orriko testu batekin lotzeko.
aria-describedby-k bezala, aria-labelledby-k zenbait id onar ditzake orriko beste elementu batzuk adierazteko, zuriunez bereizitako zerrenda baten bidez. Gaitasun horri esker, aria-labelledby bereziki erabilgarria da pertsona ikusleek kontrol bat identifikatzeko inguruko testuinguruko informazioa erabiltzen duten egoeretan. aria-labelledby erabiltzea etiketa bat testu-nodo batzuetatik abiatuta kateatzeko teknikan, orriko beste hainbat testu-elementutatik abiatuta izenak sortzen diren egoeren adibide gehiago daude.
aria-labelledby-ren funtzioa HTMLko jatorrizko label elementuaren antzekoa dirudien arren, badira zenbait desberdintasun:
-
aria-labelledby-k testu-elementu bat baino gehiago adieraz ditzake;label-ek bakarra baino ezin du adierazi. -
aria-labelledbyaskotariko elementuetan erabil daiteke;labelelementua, berriz, formulario-elementuetan soilik. -
labelbatean klik egitean, lotutako formulario-eremuak jasotzen du fokua. Hori ez da gertatzenaria-labelledby-rekin. Portaera hori behar bada, erabililabeledo inplementatu funtzionaltasun hori scripten bidez.
Adibideak
Testu-eremu soil bat etiketatzea
Hona hemen aria-labelledby testu-eremu soil batean erabiltzeko adibide bat, etiketa bat emateko berariazko etiketa baterako testurik ez dagoen baina orrian kontrola zehatz etiketatzeko erabil daitekeen beste testu bat dagoen egoera batean.
<input name="searchtxt" type="text" aria-labelledby="searchbtn">
<input name="searchbtn" id="searchbtn" type="submit" value="Search">
Graduatzaile bat etiketatzea
Jarraian, aria-labelledby kontrol graduatzaile bati etiketa bat emateko erabiltzen den adibide bat dago. Kasu honetan, etiketaren testua ondoko testu-kate luzeago baten barruan hautatzen da. Kontuan izan adibide hau sinplifikatuta dagoela etiketatze-erlazioa soilik erakusteko; kontrol pertsonalizatuak inplementatzen dituztenek ziurtatu behar dute, halaber, kontrolek gainerako betetze-irizpideak betetzen dituztela.
<p>Please select the <span id="mysldr-lbl">number of days for your trip</span></p>
<div id="mysldr" role="slider" aria-labelledby="mysldr-lbl"></div>
Hainbat iturritatik abiatutako etiketa bat
Erreferentzia anitzeko aria-labelledby-ren hurrengo adibideak label elementua erabiltzen du. Informazio-iturri bat baino gehiago aria-labelledby bidez etiketa batean nola kateatu jakiteko, ikus aria-labelledby erabiltzea etiketa bat testu-nodo batzuetatik abiatuta kateatzeko teknika.
<label id="l1" for="f3">Notify me</label>
<select name="amt" id="f3" aria-labelledby="l1 f3 l2">
<option value="1">1</option>
<option value="2">2</option>
</select>
<span id="l2">days in advance</span>
Oharra: label elementua hainbat arrazoirengatik erabiltzen da. Erabiltzaileak label elementuaren testuan klik egiten badu, dagokion formulario-eremuak jasotzen du fokua, eta, horrela, klikaren helburua handiagoa da trebetasun-arazoak dituzten pertsonentzat. Gainera, label elementua beti azaltzen da irisgarritasun-APIaren bidez. span bat erabil zitekeen; hala ere, span batek klik egiteko eremu zabalagoaren abantaila galduko luke.
Probak
Prozedura
aria-labelledby atributua duen erabiltzaile-interfazeko kontrol-elementu bakoitzerako:
- Egiaztatu
aria-labelledbyatributuaren balioa web-orriko elementu batenid-a edo zuriunez bereizitakoid-zerrenda bat dela. - Egiaztatu erreferentziatutako elementuaren edo elementuen testuak zehatz etiketatzen duela erabiltzaile-interfazeko kontrola.
Espero diren emaitzak
- 1. eta 2. egiaztapenak egiazkoak dira.
Baliabideak
- WAI-ARIA Authoring Practices Guide (WAI-ARIAren egile-praktiken gida)
- HTML to Platform Accessibility APIs Implementation Guide: Accessible Name and Description Calculation (izen eta deskribapen irisgarrien kalkulua)
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren ARIA16 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.