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

Tècnica Scripts de client WCAG 2.2

SCR29Fer que els div o span amb accions funcionin amb teclat

Nom oficial al W3C: Afegir accions accessibles per teclat a elements HTML estàtics

Versión en castellano

En poques paraules

Si un div o un span fa alguna cosa quan es prem, també ha de funcionar amb teclat. Per aconseguir-ho, necessita tabindex="0" per rebre el focus i un script que respongui a Retorn i a Espai. A més, ha d'indicar què és, per exemple amb role="button". Sempre que es pugui, és millor utilitzar directament un botó.

Per què és important

Un div o un span no reben el focus ni responen al teclat per si sols. Si només tenen un esdeveniment de clic, qui no fa servir ratolí no els pot activar.

Això afecta les persones cegues, amb tremolors o amb mobilitat reduïda. Per exemple, una pestanya «Horaris» feta amb un span seria impossible d'obrir sense ratolí.

Com es fa

  1. Primer, valoreu utilitzar un <button> o un enllaç. Ja porten el focus, el teclat i la funció correctes sense codi addicional.
  2. Si necessiteu un element genèric, afegiu-hi tabindex="0". Així entra en l'ordre de tabulació. Amb tabindex="-1" només rep el focus des d'un script.
  3. Afegiu-hi role="button" (o la funció que correspongui) i un nom clar. Sense això, el lector de pantalla no sap que és un control.
  4. A més de l'esdeveniment click, escolteu keydown o keyup. Llanceu la mateixa acció amb Retorn i amb Espai.
  5. Assegureu-vos que el focus es veu, per exemple amb un contorn a :focus-visible.
  6. Aquesta solució depèn de JavaScript. Utilitzeu-la només si la pàgina ja el necessita per funcionar.

Com comprovar-ho

  1. Feu clic amb el ratolí al control i comproveu que l'acció funciona.
  2. Recorreu la pàgina amb Tab. El control ha de rebre el focus i el focus s'ha de veure.
  3. Amb el focus al control, premeu Retorn i després Espai. Totes dues tecles han de llançar l'acció.
  4. Amb un lector de pantalla, comproveu que se n'anuncia la funció (per exemple, «botó») i el nom.

Exemple

Un div que mostra l'adreça d'una seu i respon al ratolí, a Retorn i a Espai.

<div id="ver-mapa" class="accion" tabindex="0" role="button">Mostra l'adreça de la seu</div>
<p id="mapa" hidden>Carrer Major, 1. Planta baixa.</p>
<script>
var control = document.getElementById('ver-mapa');
function mostrarMapa() { document.getElementById('mapa').hidden = false; }
control.addEventListener('click', mostrarMapa);
control.addEventListener('keydown', function (e) {
  if (e.key === 'Enter' || e.key === ' ') {
    e.preventDefault(); // evita que Espai desplaci la pàgina
    mostrarMapa();
  }
});
</script>
Veure el text complet del W3C (traducció al català)

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

Descripció

L'objectiu d'aquesta tècnica és mostrar com proporcionar accés per teclat a un control d'interfície d'usuari implementat mitjançant accions associades a elements HTML estàtics com div o span. Aquesta tècnica garanteix que l'element pugui rebre el focus establint l'atribut tabindex, i garanteix que l'acció es pugui activar des del teclat proporcionant un gestor onkeyup o onkeypress a més del gestor onclick.

Quan l'atribut tabindex té el valor 0, l'element pot rebre el focus mitjançant el teclat i s'inclou en l'ordre de tabulació del document. Quan l'atribut tabindex té el valor -1, no es pot arribar a l'element amb la tecla de tabulació, però se li pot assignar el focus per programació amb element.focus().

Com que els elements HTML estàtics no tenen accions associades, no és possible proporcionar una implementació alternativa o una explicació en entorns en què els scripts no estiguin disponibles. Aquesta tècnica només s'ha d'utilitzar en entorns en què es pugui confiar en els scripts del costat del client.

Aquests controls d'interfície d'usuari han de continuar complint el criteri de conformitat 4.1.2 Nom, funció i valor. Aplicar aquesta tècnica sense proporcionar també la informació de funció, nom i estat del control d'interfície d'usuari donarà lloc a l'error F59, Error del criteri de conformitat 4.1.2 a causa d'utilitzar scripts per convertir un div o un span en un control d'interfície d'usuari en HTML.

Exemples

Afegir una acció JavaScript a un element div

A l'element div de la pàgina se li assigna un atribut id únic i un atribut tabindex amb el valor 0. Un script utilitza el model d'objectes del document (DOM) per localitzar l'element div pel seu id i afegir-hi el gestor onclick i el gestor onkeyup. El gestor onkeyup invocarà l'acció quan es premi la tecla Retorn. Tingueu en compte que l'element div ha d'estar carregat al DOM abans de poder-lo localitzar i modificar. Això se sol aconseguir cridant l'script des de l'esdeveniment onload de l'element body. L'script que afegeix els gestors d'esdeveniments només s'executarà si l'agent d'usuari admet JavaScript i el té activat.

<script>
// this is the function to perform the action. This simple example toggles a message.
function doSomething(event) {
  var msg=document.getElementById("message");
  msg.style.display = msg.style.display=="none" ? "" : "none";
  //return false from the function to make certain
  // that the href of the link does not get invoked
  return false;
  }
  // this is the function to perform the action when the Enter key has been pressed.  
  function doSomethingOnEnter(event) {
    var key = 0;
     // Determine the key pressed, depending on whether window.event
    // or the event object is in use
    if (window.event) {
      key = window.event.keyCode;
    }
    else if (event) {
      key = event.keyCode;
    }
    // Was the Enter or Space key pressed?
    if (key == 13 || key == 32) {
      return doSomething(event);
    } 
    // The event has not been handled, so return true
    return true;
  }
  // This setUpActions() function must be called to set the onclick and onkeyup
  // event handlers onto the existing div element.
  // This function must be called after the div element with id="active" 
  // has been loaded into the DOM.
  // In this example the setUpActions() function is called from the onload event
  // for the body element.
  function setUpActions() {
    // get the div object
    var active=document.getElementById("active");
    // assign the onclick handler to the object.
    active.onclick=doSomething;
    // assign the onkeyup handler to the object.
    active.onkeyup=doSomethingOnEnter;
}
</script>
<body onload="setUpActions();">
  <p>Here is the link to modify with a javascript action:</p>
  <div>
    <span id="active" role="button" tabindex="0">Do Something</span>
  </div>
  <div aria-live="polite">
    <div id="message">Hello, world!</div>
  </div>
</body>

Exemple funcional d'aquest codi: Creating Divs with Actions using JavaScript (crear elements div amb accions mitjançant JavaScript).

Proves

Procediment

En un agent d'usuari compatible amb scripts:

  1. Fer clic al control amb el ratolí.
  2. Comprovar que l'acció de l'script s'executa correctament.
  3. Comprovar que és possible navegar fins al control i donar-li el focus mitjançant el teclat.
  4. Situar el focus del teclat al control.
  5. Comprovar que en prémer Retorn o Espai s'invoca l'acció de l'script.

Resultats esperats

  • Totes les comprovacions són certes.

Recursos

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.

Sol·licitar una auditoria

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