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

Error habitual WCAG 2.2

F15Controls personalitzats que el lector de pantalla no reconeix

Nom oficial al W3C: Error del criteri de conformitat 4.1.2 per implementar controls personalitzats que no utilitzen l'API d'accessibilitat de la tecnologia, o que la utilitzen de manera incompleta

Versión en castellano

En poques paraules

Aquest error es produeix en crear un control propi, com un interruptor, una pestanya o un control lliscant, sense indicar què és. El lector de pantalla no en coneix el nom, la funció ni l'estat. La persona no el pot fer servir, o ni tan sols sap que existeix.

Per què és important

Els controls natius d'HTML, com <button>, <input> o <select>, ja informen el navegador del que són. El navegador passa aquesta informació als lectors de pantalla i a altres productes de suport.

Un <div> amb estils i JavaScript no informa de res. Per exemple, l'interruptor «Rebre avisos per SMS» d'una àrea personal se sent com un text solt. La persona no sap que el pot activar ni si ja està activat.

Com evitar-ho

  1. Feu servir sempre que pugueu l'element natiu: <button>, <input type="checkbox">, <select> o <a href>. Ja porten tot el que cal.
  2. Si necessiteu un control propi, n'indiqueu la funció amb un role d'ARIA, per exemple role="switch" o role="tab".
  3. Doneu-li un nom: text visible, aria-label o aria-labelledby.
  4. Indiqueu-ne l'estat o el valor amb atributs com aria-checked, aria-expanded o aria-valuenow. Actualitzeu-los amb JavaScript cada vegada que canviïn.
  5. Feu que funcioni amb el teclat. Seguiu la Guia de pràctiques d'autoria d'ARIA (APG) del W3C per a aquest tipus de control.

Com comprovar-ho

  1. Obriu les eines del navegador (F12), seleccioneu el control i mireu el tauler «Accessibilitat». Hi han d'aparèixer una funció (role), un nom i, si en té, un estat.
  2. Canvieu el control (activeu-lo, desplegueu-lo o moveu el control lliscant). Comproveu que l'estat s'actualitza en aquest tauler.
  3. Amb NVDA o VoiceOver, arribeu al control amb el tabulador. Heu de sentir què és, com es diu i en quin estat està.
  4. Passeu axe DevTools o WAVE. Detecten alguns casos, com controls sense nom, però no tots.

Exemple

Interruptor per activar els avisos per SMS en una àrea personal.

<!-- Incorrecte: un div que el lector no reconeix -->
<div class="interruptor" onclick="cambiar(this)">
  Avisos per SMS
</div>

<!-- Correcte: botó amb funció i estat -->
<!-- cambiar() també actualitza aria-checked -->
<button type="button" role="switch" aria-checked="false"
  onclick="cambiar(this)">Avisos per SMS</button>
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica F15 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

S'aplica a totes les tecnologies que admeten una API d'accessibilitat.

Descripció

Quan s'utilitzen els controls estàndard de tecnologies accessibles, normalment estan programats de manera que fan servir i admeten l'API d'accessibilitat. Tanmateix, quan es creen controls personalitzats, és responsabilitat de qui desenvolupa el control garantir que aquest s'exposi correctament als usuaris a través de l'API d'accessibilitat de la plataforma. Si no es fa així, les tecnologies de suport no podran entendre què és el control ni com fer-lo servir, o potser ni tan sols sabran que existeix.

En les tecnologies que ho admeten, es pot fer servir WAI-ARIA per exposar la funció, el nom, el valor, els estats i les propietats d'un control personalitzat a través de l'API d'accessibilitat de la tecnologia.

A més de garantir que els controls personalitzats s'exposin correctament als usuaris a través de l'API d'accessibilitat de la plataforma, cal tenir en compte moltes altres consideracions perquè el control sigui accessible per al nombre més gran possible de persones. La funcionalitat amb teclat, la mida de l'objectiu i els requisits de contrast de color són només algunes de les consideracions addicionals que cal tenir en compte, i totes van més enllà del que cobreixen el criteri de conformitat 4.1.2 Nom, funció i valor i aquesta tècnica.

Exemples

Es dissenya un reproductor de música amb controls personalitzats que semblen notes musicals que s'estiren per ajustar el volum, el to, etc. El programador no fa que el nou control admeti l'API d'accessibilitat. Com a resultat, els controls no es poden identificar ni fer servir des de la tecnologia de suport.

Proves

Procediment

  1. Utilitzant el comprovador d'accessibilitat de la tecnologia (o, si no està disponible, inspeccionant el codi amb les eines per a desenvolupadors d'un navegador, o provant amb una tecnologia de suport), comprovar els controls per veure si admeten l'API d'accessibilitat.

Resultats esperats

  • Si la comprovació núm. 1 és falsa, es dona aquesta condició d'error i el contingut no compleix aquest criteri de conformitat.

Recursos

Com ho comprovem a ADDAW

Aquest error és un dels que busquem en cada auditoria d'ADDAW. Us el lliurem amb captures i la manera de corregir-lo.

Sol·licitar una auditoria

Basat en la tècnica F15 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.