Error habitual WCAG 2.2
F79Menús i llistes a mida que no informen d'on és el focus
Nom oficial al W3C: Error del criteri de conformitat 4.1.2 perquè l'estat de focus d'un component d'interfície d'usuari no és determinable per programari o no hi ha cap notificació disponible del canvi d'estat de focus
En poques paraules
Aquest error apareix en menús, llistes o pestanyes programats a mà. El component ressalta a la pantalla l'opció activa, però no informa el navegador de quina opció té el focus. Així, el lector de pantalla no sap què ha de llegir i l'ampliador no sap quina zona ha de mostrar.
Per què és important
El focus és el punt de la pàgina que rep el que es prem al teclat. Els lectors de pantalla (programes que llegeixen en veu alta el que hi ha a la pantalla) llegeixen l'element que té el focus. Els ampliadors de pantalla mouen la zona ampliada fins a ell.
Amb els botons i camps normals d'HTML, el navegador fa aquesta feina sol. En un component fet a mida, el ressaltat pot ser només un canvi de color. La persona cega sent «menú», però no l'opció en què és. Qui utilitza un ampliador veu una altra part de la pàgina. Al final, pot triar l'opció equivocada.
Com evitar-ho
- Utilitzeu elements nadius sempre que pugueu:
button,select,aoinput. Informen del focus sense feina addicional. - En un component a mida, moveu el focus de debò a l'opció activa amb
focus(). Per rebre'l, les opcions necessitentabindex: 0 a l'activa i -1 a les altres. - Una altra opció: deixeu el focus al contenidor i assenyaleu l'opció activa amb
aria-activedescendant. Canvieu-ne el valor cada vegada que canviï l'opció. - Doneu a cada part la seva funció amb ARIA, per exemple
role="listbox"irole="option". Així el lector la pot anunciar bé. - No us limiteu a canviar una classe CSS per ressaltar l'opció. El canvi també ha d'arribar al navegador.
Com comprovar-ho
- Recorreu el component amb el teclat: Tab i les fletxes.
- Activeu un lector de pantalla, com NVDA a Windows o VoiceOver a Mac. Comproveu que anuncia l'opció nova a cada moviment.
- A la consola de les eines del navegador (F12), escriviu
document.activeElement. Veureu quin element té el focus. Si és el contenidor, ha d'assenyalar l'opció ambaria-activedescendant. - Si el lector només anuncia el nom del menú, o repeteix sempre la mateixa opció, hi ha error.
Exemple
Llista a mida que assenyala l'opció activa amb aria-activedescendant; un script canvia aquest valor en prémer les fletxes.
<ul role="listbox" tabindex="0" aria-label="Província"
aria-activedescendant="prov-2">
<li role="option" id="prov-1">Alacant</li>
<li role="option" id="prov-2" aria-selected="true">Múrcia</li>
<li role="option" id="prov-3">València</li>
</ul>
<!-- En prémer les fletxes, l'script actualitza
aria-activedescendant i aria-selected -->
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica F79 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
Totes les tecnologies
Descripció
Que un component d'interfície d'usuari tingui el focus és una faceta especialment important del seu estat. Molts tipus de tecnologia de suport depenen del seguiment del focus actual del teclat. Els lectors de pantalla mouen el punt d'atenció de l'usuari al component d'interfície d'usuari que té el focus, i els ampliadors de pantalla canvien la visualització del contingut perquè el component enfocat sigui visible. Si no es notifica a la tecnologia de suport quan el focus es mou a un component nou, l'usuari es confondrà en intentar interactuar amb el component equivocat.
Tot i que els agents d'usuari solen gestionar aquesta funcionalitat per als controls estàndard, els components d'interfície d'usuari programats a mida són responsables d'utilitzar les API d'accessibilitat perquè la informació i les notificacions del focus estiguin disponibles.
Exemples
Un menú personalitzat mostra els elements de menú dibuixant-los de manera explícita, gestionant directament els esdeveniments de ratolí i de teclat i ressaltant l'element de menú seleccionat en cada moment. El programador no exposa a través de l'API d'accessibilitat quin element de menú té el focus, de manera que la tecnologia de suport només pot determinar que el focus és en algun lloc del menú i no pot determinar quin element de menú el té.
Proves
Procediment
- Utilitzant el verificador d'accessibilitat de la tecnologia (o, si no està disponible, inspeccionant el codi o provant amb una tecnologia de suport), comprovar si els controls exposen l'estat de focus a través de l'API d'accessibilitat.
- Utilitzant el verificador d'accessibilitat de la tecnologia (o, si no està disponible, inspeccionant el codi o provant amb una tecnologia de suport), comprovar si es notifica a la tecnologia de suport quan el focus passa d'un control a un altre.
Resultats esperats
- Si la comprovació núm. 1 o la comprovació núm. 2 é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.
Basat en la tècnica F79 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.