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

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

Versión en castellano

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

  1. Utilitzeu primer l'element natiu: <button>, <input type="checkbox">, <a href> o <select>. Ja porten funció, estat i funcionament amb el teclat.
  2. Si heu d'utilitzar un div o un span, afegiu-hi un role d'ARIA, com ara role="checkbox" o role="button". ARIA són atributs que donen informació addicional als lectors de pantalla.
  3. Indiqueu l'estat amb atributs com aria-checked o aria-pressed, i actualitzeu-los des de l'script.
  4. Doneu-li focus amb tabindex="0" i programeu les tecles habituals, com Espai en una casella.
  5. Assegureu-vos que el control té un nom, per exemple el seu text visible.

Com comprovar-ho

  1. Cerqueu elements div o span amb esdeveniments com onclick. Al Firefox, la pestanya «Inspector» marca amb «event» els elements que tenen esdeveniments.
  2. Per a cadascun, comproveu si té un role adequat.
  3. Al tauler «Accessibilitat» de les eines del navegador (F12), mireu-ne la funció («Role»). No ha de ser «generic» ni estar buida.
  4. 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.

Associar gestors d'esdeveniments a elements que normalment no són interactius, com 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

  1. 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).
  2. Comprovar si la funció del control ja està definida de manera nativa al llenguatge de marcatge.
  3. 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

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