Addaw, joan hasierara Egin dohaintza

Teknika ARIA WCAG 2.2

ARIA16Kontrolei izena ematea aria-labelledby bidez

Izen ofiziala W3Cn: aria-labelledby erabiltzea erabiltzaile-interfazeko kontrolei izena emateko

Versión en castellano · Versió en català

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

  1. Ahal duzun guztietan, erabili <label>: etiketa sakatzean, fokua eremura joaten da. aria-labelledby erabilita, hori ez da gertatzen.
  2. Erabili aria-labelledby etiketa batentzako lekurik ez dagoenean edo izena lehendik dagoen testu batetik datorrenean: izenburu bat, botoi baten testua, taula-gelaxka bat.
  3. Eman id bakar bat izen gisa erabiliko den testuari.
  4. Gehitu kontrolari aria-labelledby, id horrekin. Testu bat baino gehiago badira, jarri id-ak zuriunez bereizita, irakurri behar diren ordenan.
  5. Kontuan izan aria-labelledby-k lehentasuna duela <label>-en eta aria-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.

Adibide okerraren pantaila-argazkia: Izenik gabeko bilaketa-eremua
Horrela ikusten da adibide okerra.

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

Pantaila-irakurgailua (NVDA edo VoiceOver)

  1. Iritsi bilaketa-eremura tabuladorearekin eta entzun nola iragartzen den.
  2. Egiaztatu iragarritako izena adierazten duen testu ikusgarriarekin bat datorrela.

Hau iragarri beharko luke: «Bilatu, bilaketa-eremua» (VoiceOver) edo «Bilatu, edizioa» (NVDA)

Nabigatzailearen tresnak

  1. Ireki garapen-tresnak (F12) eta aukeratu Irisgarritasuna fitxa.
  2. Hautatu eremua eta egiaztatu haren izena («Name») «Bilatu» dela eta aria-labelledby-tik datorrela.
  3. Egiaztatu aria-labelledby-ko id bakoitza orrian badagoela eta ez dagoela errepikatuta.

Teklatua

  1. Zeharkatu bilatzailea Tab teklarekin. Eremuak eta botoiak fokua jaso behar dute, adierazle ikusgarri batekin.
  2. Kontuan izan, label-ekin ez bezala, aria-labelledby-k adierazten duen testua sakatzeak ez duela fokua eremura eramaten.

Balidazio automatikoa

  1. axe DevTools-ek adibide okerreko izenik gabeko eremua detektatzen du (label araua). WAVEk «Missing form label» gisa markatzen du.
  2. Ez dute detektatzen aukeratutako testuak kontrola ondo deskribatzen duen. Testu okerra adierazten duen aria-labelledby batek gainditu egiten du berrikuspen automatikoa.

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-labelledby askotariko elementuetan erabil daiteke; label elementua, berriz, formulario-elementuetan soilik.
  • label batean klik egitean, lotutako formulario-eremuak jasotzen du fokua. Hori ez da gertatzen aria-labelledby-rekin. Portaera hori behar bada, erabili label edo 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:

  1. Egiaztatu aria-labelledby atributuaren balioa web-orriko elementu baten id-a edo zuriunez bereizitako id-zerrenda bat dela.
  2. Egiaztatu erreferentziatutako elementuaren edo elementuen testuak zehatz etiketatzen duela erabiltzaile-interfazeko kontrola.

Espero diren emaitzak

  • 1. eta 2. egiaztapenak egiazkoak dira.

Baliabideak

Nola egiaztatzen dugun ADDAWn

ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.

Eskatu auditoria bat

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.