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

Tècnica Scripts de client WCAG 2.2

SCR20Programar cada acció perquè funcioni amb el ratolí i amb el teclat

Nom oficial al W3C: Utilitzar funcions de teclat juntament amb les específiques d'altres dispositius

Versión en castellano

En poques paraules

Si un script respon a un esdeveniment de ratolí, també ha de respondre a l'equivalent de teclat. Per exemple, al costat de mouseover s'utilitza focus, i al costat de mousedown s'utilitza keydown. Així qualsevol funció de la pàgina es pot fer servir amb ratolí, amb teclat o amb altres dispositius.

Per què és important

Moltes persones naveguen només amb el teclat: persones cegues, persones amb tremolors o mobilitat reduïda, o qui fa servir un polsador o el control per veu.

Si un menú només s'obre en passar-hi el ratolí, o una targeta de producte només respon a un clic sobre un div, aquestes persones no els poden fer servir.

Com es fa

  1. Sempre que pugueu, utilitzeu elements natius com <button> o <a href>. Amb aquests elements, l'esdeveniment click ja funciona amb Retorn o Espai.
  2. Aparelleu els esdeveniments: mouseover amb focus, mouseout amb blur, mousedown amb keydown i mouseup amb keyup.
  3. Si utilitzeu un element no natiu, doneu-li tabindex="0" i un role adequat, i feu que respongui a les tecles Retorn i Espai.
  4. Eviteu accions que només existeixen amb el ratolí, com el doble clic o arrossegar, sense una alternativa.

Com comprovar-ho

  1. Feu una llista de tot el que és interactiu: menús, botons, pestanyes, carrusels, targetes.
  2. Deixeu el ratolí de banda i recorreu la pàgina amb Tab, Maj + Tab, Retorn, Espai i les fletxes.
  3. Comproveu que podeu arribar a cada element i fer servir totes les seves funcions.

Exemple

Un element no natiu que respon al clic i a les tecles Retorn i Espai.

<div role="button" tabindex="0" id="filtrar">Filtra els resultats</div>
<script>
  const boton = document.getElementById("filtrar");
  boton.addEventListener("click", filtrar);
  boton.addEventListener("keydown", (e) => {
    if (e.key === "Enter" || e.key === " ") {
      e.preventDefault();
      filtrar();
    }
  });
</script>
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica SCR20 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 tot el contingut que utilitza scripts per implementar funcionalitat.

Descripció

L'objectiu d'aquesta tècnica és il·lustrar l'ús conjunt d'esdeveniments específics de teclat i esdeveniments específics de ratolí en codi que té una funció de script associada a un esdeveniment. Utilitzar junts els esdeveniments específics de teclat i els específics de ratolí garanteix que el contingut es pugui fer servir amb una àmplia varietat de dispositius. Per exemple, un script pot dur a terme la mateixa acció quan detecta la pulsació d'una tecla que quan es fa clic amb un botó del ratolí. Aquesta tècnica va més enllà del requisit d'accés mitjançant teclat del criteri de conformitat, ja que inclou no només l'accés mitjançant teclat sinó també l'accés mitjançant altres dispositius.

En JavaScript, alguns dels gestors d'esdeveniments més utilitzats són onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onload, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup, onreset, onselect, onsubmit i onunload. Algunes funcions específiques de ratolí tenen una funció específica de teclat lògicament equivalent (com ara «onmouseover» i «onfocus»). Cal proporcionar un gestor d'esdeveniments de teclat que executi la mateixa funció que el gestor d'esdeveniments de ratolí.

La taula següent suggereix gestors d'esdeveniments de teclat amb què aparellar els gestors d'esdeveniments de ratolí.

Correspondències entre gestors de dispositius
Utilitzeu... ...juntament amb
mousedown keydown
mouseup keyup
click [1] keypress [2]
mouseover focus
mouseout blur

1 Tot i que click és, en principi, un gestor d'esdeveniments de ratolí, la majoria dels agents d'usuari HTML també processen aquest esdeveniment quan s'activa un control HTML natiu (p. ex., un botó o un enllaç), independentment que s'hagi activat amb el ratolí o amb el teclat. A la pràctica, per tant, no cal duplicar aquest esdeveniment en afegir gestors a elements HTML que poden rebre el focus de manera nativa. Tanmateix, sí que cal en afegir gestors a altres esdeveniments, com a l'exemple 2 que figura més avall.

2 Com que el gestor de l'esdeveniment keypress reacciona davant de qualsevol tecla, la funció gestora de l'esdeveniment ha de comprovar primer que s'ha premut la tecla Retorn abans de continuar amb el tractament de l'esdeveniment. Altrament, el gestor de l'esdeveniment s'executarà cada vegada que l'usuari premi qualsevol tecla, fins i tot la tecla de tabulació per sortir del control, cosa que normalment no és desitjable.

Algunes funcions específiques de ratolí (com ara dblclick i mousemove) no tenen una funció específica de teclat equivalent. Això significa que potser algunes funcions s'hauran d'implementar de manera diferent per a cada dispositiu (per exemple, incloent-hi una sèrie de botons per executar, mitjançant el teclat, l'equivalent de les funcions específiques de ratolí implementades).

Exemples

En aquest exemple d'un enllaç amb imatge, la imatge canvia quan l'usuari situa el punter a sobre. Per oferir una experiència similar als usuaris de teclat, la imatge també canvia quan l'usuari hi arriba amb la tecla de tabulació.

<a href="menu.php" onmouseover="swapImageOn('menu')" onfocus="swapImageOn('menu')" 
   onmouseout="swapImageOff('menu')" onblur="swapImageOff('menu')"> 
   <img id="menu" src="menu_off.gif" alt="Menu"> 
</a>

Aquest exemple mostra un control d'enllaç personalitzat en què es poden fer servir tant el ratolí com el teclat per activar la funció. L'esdeveniment onclick del ratolí es duplica amb un esdeveniment onkeypress de teclat adequat. L'atribut tabindex garanteix que el teclat tingui una parada de tabulació a l'element span. Tingueu en compte que, en aquest exemple, la funció nextPage() hauria de comprovar que la tecla premuda ha estat Retorn; altrament, respondrà a totes les accions de teclat mentre l'span tingui el focus, cosa que no és el comportament desitjat.

<span onclick="nextPage();" onkeypress="nextPage();" role="link" tabindex="0">
  <img alt="Go to next page" src="arrow.gif">
</span>

Proves

Procediment

  1. Localitzar tota la funcionalitat interactiva.
  2. Comprovar que es pot accedir a tota la funcionalitat interactiva utilitzant únicament el teclat.

Resultats esperats

  • La comprovació núm. 2 és certa.

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