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
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
- Mantingueu l'etiqueta visible del camp amb
<label>. La descripció completa l'etiqueta; no la substitueix. - Poseu el text d'ajuda en un element amb un
idúnic, per exempleid="ayuda-clave". - Afegiu al control
aria-describedby="ayuda-clave". El text ha de ser a la mateixa pàgina, no en un altre document. - Si hi ha diverses ajudes, escriviu-ne els
idseparats per espais, en l'ordre en què s'han de llegir. - També serveix en botons. Un botó «Elimina el compte» pot enllaçar l'avís que l'acció no es pot desfer.
- Utilitzeu textos breus. El lector de pantalla els llegirà cada vegada que la persona arribi al control.
Com comprovar-ho
- 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.
- Comproveu que cada
idd'aria-describedbyexisteix a la pàgina i no està repetit. - Amb NVDA o VoiceOver, arribeu al camp amb el tabulador. Heu de sentir l'etiqueta i, a continuació, l'ajuda.
- 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
- Comprovar que hi ha un control de la interfície d'usuari amb un atribut
aria-describedbyque fa referència a un o més elements mitjançant unidúnic. - 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
- WAI-ARIA Overview (introducció a WAI-ARIA).
- WAI-ARIA Authoring Practices Guide (guia de pràctiques d'autor de WAI-ARIA).
- HTML Accessibility API Mappings
- Accessible Name and Description Computation (càlcul del nom i la descripció accessibles).
-
Atribut
aria-describedby(MDN). - Using WAI-ARIA in HTML (ús de WAI-ARIA en HTML).
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.
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.