Error habitual WCAG 2.2
F59Controls fets amb div o span que no diuen què són
Nom oficial al W3C: Error del criteri de conformitat 4.1.2 per utilitzar scripts per convertir un div o un span en un control d'interfície d'usuari en HTML sense proporcionar una funció (role) al control
En poques paraules
Es produeix quan un botó, una casella o una pestanya es fabrica amb un div o un span i JavaScript, sense indicar-ne la funció. El lector de pantalla no sap què és aquest element ni en quin estat és. El millor és utilitzar l'element HTML natiu; si no es pot, cal afegir el role d'ARIA adequat.
Per què és important
Un lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla) anuncia cada control amb el seu tipus: «botó», «casella de selecció, marcada», «pestanya». Així la persona sap què hi pot fer.
Un div o un span no tenen funció pròpia. Encara que semblin una casella, el lector només en llegeix el text. La persona no sap que el pot prémer ni si està marcat. A més, aquests elements no reben el focus del teclat per si sols.
Com evitar-ho
- Utilitzeu primer l'element natiu:
<button>,<input type="checkbox">,<a href>o<select>. Ja porten funció, estat i funcionament amb el teclat. - Si heu d'utilitzar un
divo unspan, afegiu-hi unroled'ARIA, com ararole="checkbox"orole="button". ARIA són atributs que donen informació addicional als lectors de pantalla. - Indiqueu l'estat amb atributs com
aria-checkedoaria-pressed, i actualitzeu-los des de l'script. - Doneu-li focus amb
tabindex="0"i programeu les tecles habituals, com Espai en una casella. - Assegureu-vos que el control té un nom, per exemple el seu text visible.
Com comprovar-ho
- Cerqueu elements
divospanamb esdeveniments comonclick. Al Firefox, la pestanya «Inspector» marca amb «event» els elements que tenen esdeveniments. - Per a cadascun, comproveu si té un
roleadequat. - Al tauler «Accessibilitat» de les eines del navegador (F12), mireu-ne la funció («Role»). No ha de ser «generic» ni estar buida.
- Arribeu al control amb NVDA o VoiceOver. N'ha d'anunciar el tipus i l'estat.
Exemple
Una casella nativa i, si no hi ha més remei, un span amb funció, estat i focus (l'script també ha de gestionar la tecla Espai).
<!-- Millor opció: casella nativa -->
<label>
<input type="checkbox"> Incloure la signatura
</label>
<!-- Si no hi ha més remei: span amb role i estat -->
<span role="checkbox" aria-checked="false" tabindex="0">
Incloure la signatura
</span>
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica F59 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
HTML
Descripció
Aquest error mostra com l'ús d'elements HTML genèrics per crear controls
d'interfície d'usuari pot fer que aquests controls siguin inaccessibles per a les tecnologies
de suport. Les tecnologies de suport necessiten conèixer la funció i l'estat actual
d'un component per poder transmetre aquesta informació a l'usuari. Molts
elements HTML tenen funcions ben definides, com els enllaços, els botons, els camps de text,
etc. Els elements genèrics com div i span no
tenen cap funció predefinida. Quan s'utilitzen aquests elements genèrics per crear
controls d'interfície d'usuari en HTML, és possible que la tecnologia de suport no disposi de la
informació necessària per descriure el control i interactuar-hi.
span i div, pot resultar desorientador per als
usuaris. Fins i tot si es té cura de proporcionar accés per teclat a aquests elements,
als usuaris els pot costar descobrir que hi ha controls interactius
al contingut o entendre quin tipus de comportament poden esperar
d'ells. Per exemple, és possible que els usuaris no sàpiguen quines pulsacions de tecles admet
l'script per activar l'element. A més, aquests elements no
generen els mateixos esdeveniments del sistema operatiu que els elements interactius, de manera que
és possible que la tecnologia de suport no rebi cap notificació quan l'usuari els activa.Accessible Rich Internet Applications (WAI-ARIA) descriu mecanismes per proporcionar la informació necessària sobre la funció i l'estat i crear així controls d'interfície d'usuari totalment accessibles.
Exemples
L'exemple següent és un error perquè crea una casella de selecció amb un span i una imatge.
<p>
<span onclick="toggleCheckbox('chkbox')">
<img src="unchecked.gif" id="chkbox" alt=""> Include Signature
</span>
</p>
Aquest és el codi de l'script que canvia l'origen de la imatge quan es fa clic amb el ratolí a l'span.
var CHECKED = "check.gif";
var UNCHECKED = "unchecked.gif";
function toggleCheckbox(imgId) {
var theImg = document.getElementById(imgId);
if (theImg.src.lastIndexOf(CHECKED)!= -1) {
theImg.src = UNCHECKED;
// additional code to implement unchecked action
}
else {
theImg.src = CHECKED;
// additional code to implement checked action
}
}
Una casella de selecció creada d'aquesta manera no funcionarà amb les tecnologies de suport, ja que no hi ha cap informació que la identifiqui com a casella de selecció. A més, aquest exemple tampoc no es pot fer servir amb el teclat, de manera que no compliria la pauta 2.1.
Proves
Procediment
- Examinar el codi font processat per cercar elements que tinguin gestors d'esdeveniments assignats al marcatge o mitjançant scripts (cosa que indica que l'element és un control d'interfície d'usuari).
- Comprovar si la funció del control ja està definida de manera nativa al llenguatge de marcatge.
- Comprovar si s'ha utilitzat un altre mètode vàlid, com l'assignació d'un role de WAI-ARIA adequat, per definir la funció del control.
Resultats esperats
Si les comprovacions núm. 2 I núm. 3 són falses, es dona la condició d'error.
Recursos
- Accessible Rich Internet Applications (WAI-ARIA)
- WAI-ARIA Authoring Practices Guide (guia de pràctiques d'autoria de WAI-ARIA)
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 F59 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.