Addaw, anar a la pàgina d'inici Donar

Tècnica ARIA WCAG 2.2

ARIA1Relacionar instruccions i ajudes amb el seu control mitjançant aria-describedby

Nom oficial al W3C: Utilitzar la propietat aria-describedby per proporcionar una etiqueta descriptiva als controls de la interfície d'usuari

Versión en castellano

En poques paraules

L'atribut aria-describedby uneix un control, com ara un camp o un botó, amb un text d'ajuda que ja és a la pàgina. Així, el lector de pantalla llegeix primer el nom del control i després aquesta ajuda. Serveix per a instruccions, formats esperats o avisos que no caben a l'etiqueta.

Per què és important

Una persona cega utilitza un lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla). Sol saltar de camp en camp amb el tabulador. Si les instruccions són en un paràgraf a part, no les sent en arribar al camp.

Per exemple, en el registre d'una seu electrònica, la regla «mínim 8 caràcters i un número» apareix sota la contrasenya. Sense aquesta relació, la persona descobreix la regla quan el formulari li dona error.

Com es fa

  1. Mantingueu l'etiqueta visible del camp amb <label>. La descripció completa l'etiqueta; no la substitueix.
  2. Poseu el text d'ajuda en un element amb un id únic, per exemple id="ayuda-clave".
  3. Afegiu al control aria-describedby="ayuda-clave". El text ha de ser a la mateixa pàgina, no en un altre document.
  4. Si hi ha diverses ajudes, escriviu-ne els id separats per espais, en l'ordre en què s'han de llegir.
  5. També serveix en botons. Un botó «Elimina el compte» pot enllaçar l'avís que l'acció no es pot desfer.
  6. Utilitzeu textos breus. El lector de pantalla els llegirà cada vegada que la persona arribi al control.

Com comprovar-ho

  1. Obriu les eines del navegador (tecla F12), seleccioneu el control i cerqueu el tauler «Accessibilitat». A «Description» hi ha d'aparèixer el text d'ajuda.
  2. Comproveu que cada id d'aria-describedby existeix a la pàgina i no està repetit.
  3. Amb NVDA o VoiceOver, arribeu al camp amb el tabulador. Heu de sentir l'etiqueta i, a continuació, l'ajuda.
  4. Llegiu l'ajuda i confirmeu que realment aporta informació sobre aquest control.

Exemple

Camp de contrasenya d'un formulari de registre amb els requisits associats.

<label for="clave">Contrasenya</label>
<input type="password" id="clave" aria-describedby="ayuda-clave">
<p id="ayuda-clave">
  Mínim 8 caràcters, amb almenys un número.
</p>
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica ARIA1 de Techniques for WCAG 2.2, del W3C. Pot contenir errors. L'únic document oficial i normatiu és la versió original en anglès, publicada al lloc web del W3C.

Aplicabilitat

Tecnologies compatibles amb Accessible Rich Internet Applications (WAI-ARIA).

Descripció

L'objectiu d'aquesta tècnica és mostrar com utilitzar la propietat aria-describedby de WAI-ARIA per proporcionar informació descriptiva, determinable per programari, sobre un element de la interfície d'usuari. La propietat aria-describedby es pot utilitzar per vincular informació descriptiva a un o més elements mitjançant una llista de referències d'id. La llista de referències d'id conté un o més id únics d'elements.

Consulteu ARIA in HTML per obtenir informació sobre com proporcionar estats i propietats de WAI-ARIA amb HTML. Els estats i les propietats de WAI-ARIA també són compatibles amb altres llenguatges; consulteu la documentació d'aquests llenguatges.

La propietat aria-describedby no està pensada per fer referència a descripcions situades en un recurs extern: com que es tracta d'un id, ha de fer referència a un element del mateix document DOM.

Exemples

Utilitzar aria-describedby per associar instruccions a camps de formulari

Exemple de camp de formulari que utilitza aria-describedby per associar instruccions als camps de formulari quan ja hi ha una etiqueta de formulari.

<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>

Utilitzar la propietat aria-describedby per proporcionar informació més detallada sobre el botó

<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>

Proves

Procediment

  1. Comprovar que hi ha un control de la interfície d'usuari amb un atribut aria-describedby que fa referència a un o més elements mitjançant un id únic.
  2. Comprovar que l'element o els elements referenciats proporcionen informació addicional sobre el control de la interfície d'usuari.

Resultats esperats

  • Les comprovacions núm. 1 i núm. 2 són certes.

Recursos

Com ho comprovem a ADDAW

En cada auditoria d'ADDAW revisem aquesta tècnica pàgina per pàgina i us lliurem els errors amb captures i la manera de corregir-los.

Sol·licitar una auditoria

Basat en la tècnica ARIA1 del W3C (WCAG 2.2). Explicació i exemples: ADDAW. Traducció no oficial del text del W3C © W3C, llicència de documents del W3C. Heu vist un error? Escriviu-nos.