Addaw, joan hasierara Egin dohaintza

Teknika ARIA WCAG 2.2

ARIA1Argibideak eta laguntzak beren kontrolarekin lotzea aria-describedby bidez

Izen ofiziala W3Cn: aria-describedby propietatea erabiltzea erabiltzaile-interfazeko kontrolei etiketa deskribatzailea emateko

Versión en castellano · Versió en català

Laburbilduz

aria-describedby atributuak kontrol bat (eremu bat edo botoi bat, adibidez) orrian dagoen laguntza-testu batekin lotzen du. Horrela, pantaila-irakurgailuak kontrolaren izena irakurtzen du lehenik, eta ondoren laguntza hori. Argibideetarako, espero diren formatuetarako edo etiketan sartzen ez diren oharretarako balio du.

Zergatik da garrantzitsua

Pertsona itsu batek pantaila-irakurgailua erabiltzen du (pantailan dagoena ozen irakurtzen duen programa). Normalean, eremu batetik bestera jauzi egiten du tabuladorearekin. Argibideak aparteko paragrafo batean badaude, ez ditu entzuten eremura iristean.

Adibidez, egoitza elektroniko bateko erregistroan, «gutxienez 8 karaktere eta zenbaki bat» araua pasahitzaren azpian agertzen da. Lotura hori gabe, pertsonak araua ezagutuko du formularioak errorea ematen dionean.

Nola egiten da

  1. Mantendu eremuaren etiketa ikusgaia <label> elementuarekin. Deskribapenak etiketa osatzen du; ez du ordezten.
  2. Jarri laguntza-testua id bakarra duen elementu batean; adibidez, id="ayuda-clave".
  3. Gehitu kontrolari aria-describedby="ayuda-clave". Testuak orri berean egon behar du, ez beste dokumentu batean.
  4. Laguntza bat baino gehiago badaude, idatzi haien id-ak zuriunez bereizita, irakurri behar diren ordenan.
  5. Botoietan ere balio du. «Ezabatu kontua» botoi batek ekintza desegin ezin dela dioen oharra lot dezake.
  6. Erabili testu laburrak. Pantaila-irakurgailuak irakurri egingo ditu pertsona kontrolera iristen den bakoitzean.

Nola egiaztatu

  1. Ireki nabigatzailearen tresnak (F12 tekla), hautatu kontrola eta bilatu «Irisgarritasuna» panela. «Description» atalean laguntza-testuak agertu behar du.
  2. Egiaztatu aria-describedby atributuko id bakoitza orrian badagoela eta ez dagoela errepikatuta.
  3. NVDA edo VoiceOver erabiliz, iritsi eremura tabuladorearekin. Etiketa entzun behar duzu eta, jarraian, laguntza.
  4. Irakurri laguntza eta berretsi benetan kontrol horri buruzko informazioa ematen duela.

Adibidea

Erregistro-formulario bateko pasahitz-eremua, bere betekizunak lotuta dituela.

<label for="clave">Pasahitza</label>
<input type="password" id="clave" aria-describedby="ayuda-clave">
<p id="ayuda-clave">
  Gutxienez 8 karaktere, eta horien artean zenbaki bat gutxienez.
</p>
Ikusi W3Cren testu osoa (euskarazko itzulpena)

W3Cren Techniques for WCAG 2.2 dokumentuko ARIA1 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 erakustea nola erabili WAI-ARIAren aria-describedby propietatea erabiltzaile-interfazeko elementu bati buruzko informazio deskribatzailea emateko, programatikoki zehaztu daitekeena. aria-describedby propietatea informazio deskribatzailea elementu bati edo gehiagori lotzeko erabil daiteke, id erreferentzien zerrenda baten bidez. id erreferentzien zerrendak elementuen id bakar bat edo gehiago ditu.

Kontsultatu ARIA in HTML WAI-ARIAren egoerak eta propietateak HTMLrekin nola eman jakiteko. WAI-ARIAren egoerak eta propietateak beste lengoaia batzuekin ere bateragarriak dira; kontsultatu lengoaia horien dokumentazioa.

aria-describedby propietatea ez dago kanpoko baliabide batean dauden deskribapenei erreferentzia egiteko pentsatuta: id bat denez, DOM dokumentu bereko elementu bati egin behar dio erreferentzia.

Adibideak

aria-describedby erabiltzea argibideak formularioko eremuekin lotzeko

Formularioko eremu baten adibidea; aria-describedby erabiltzen du argibideak formularioko eremuekin lotzeko, formularioko etiketa bat badagoenean.

<form>
  <label for="fname">First name</label>
  <input aria-describedby="int2" autocomplete="given-name" id="fname" type="text">
  <p id="int2">Your first name is sometimes called your "given name".</p>
</form>

aria-describedby propietatea erabiltzea botoiari buruzko informazio zehatzagoa emateko

<div>
  <span id="fontDesc">Select the font faces and sizes to be used on this page</span>
  <button aria-describedby="fontDesc" id="fontB" type="button">Fonts</button>
</div>
<div>
  <span id="colorDesc">Select the colors to be used on this page</span>
  <button aria-describedby="colorDesc" id="colorB" type="button">Colors</button>
</div>
<div>
  <span id="customDesc">Customize the layout and styles used on this page</span>
  <button aria-describedby="customDesc" id="customB" type="button">Customize</button>
</div>

Probak

Prozedura

  1. Egiaztatu badagoela erabiltzaile-interfazeko kontrol bat aria-describedby atributuarekin, elementu bati edo gehiagori id bakar baten bidez erreferentzia egiten diena.
  2. Egiaztatu erreferentziatutako elementuak edo elementuek erabiltzaile-interfazeko kontrolari buruzko informazio gehigarria ematen dutela.

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 ARIA1 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.