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

Tècnica Scripts de client WCAG 2.2

SCR35Associar les accions de JavaScript a botons i enllaços

Nom oficial al W3C: Fer accessibles per teclat les accions mitjançant l'esdeveniment onclick d'enllaços i botons

Versión en castellano · Irakurri fitxa hau euskaraz

En poques paraules

Quan un script fa alguna cosa en prémer un control, aquest control ha de ser un botó o un enllaç de debò. Aquests elements reben el focus, i el seu esdeveniment click també es llança amb el teclat. Així l'acció funciona igual amb ratolí, amb teclat i amb lectors de pantalla.

Per què és important

Molts webs posen l'esdeveniment de clic en un div, un span o una imatge. Amb ratolí funciona, però aquests elements no reben el focus ni responen a les tecles.

Qui navega amb teclat, amb un lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla) o amb un polsador no pot activar l'acció. Per exemple, no podria veure l'horari d'una oficina ni afegir un producte a la cistella.

Com es fa

  1. Si l'acció canvia alguna cosa a la pàgina (mostrar, amagar, afegir, calcular), utilitzeu <button type="button">.
  2. Si porta a un altre lloc, utilitzeu un enllaç <a> amb href. Sense href no rep el focus.
  3. Associeu el script a l'esdeveniment click. Encara que el nom suggereixi el ratolí, també es llança amb el teclat: amb Retorn en els enllaços i amb Retorn o Espai en els botons.
  4. No llanceu l'acció amb esdeveniments només de ratolí, com mousedown o mouseover.
  5. Si la pàgina ha de funcionar sense JavaScript, doneu una alternativa. Pot ser un href a una pàgina amb la mateixa funció o un formulari que s'enviï al servidor.
  6. Si el botó és una imatge (<input type="image">), poseu-li un alt que digui què fa.

Exemple pràctic

Fitxa d'una oficina municipal amb un control que mostra o amaga l'horari d'atenció. És freqüent fer-ho amb un div que respon al clic, en lloc de fer-ho amb un botó.

Així no: Un div amb onclick que fa de botó

El div respon al clic del ratolí. Però no rep el focus ni reacciona a Retorn o Espai: amb teclat no hi ha manera de veure l'horari. A més, el lector de pantalla el llegeix com a text normal, no com un control.

Captura de pantalla de l'exemple incorrecte: Un div amb onclick que fa de botó
Així es veu l'exemple incorrecte.

La demostració conté, a propòsit, l'error d'accessibilitat que s'explica.

Mostra el codi de l'exemple incorrecte
<h2>Oficina d'Atenció Ciutadana</h2>
<div class="accion" onclick="verHorario(this)">Mostra l'horari d'atenció</div>
<p id="horario" hidden>De dilluns a divendres, de 9.00 a 14.00. Dijous, també de 16.30 a 18.30.</p>
<style>
  h2 { font-size: 1.1em; }
  .accion { display: inline-block; background: #744E9A; color: #fff; border: 0; padding: .5em 1em; font: inherit; cursor: pointer; }
</style>
<script>
function verHorario(control) {
  var horario = document.getElementById('horario');
  horario.hidden = !horario.hidden;
}
</script>

Així sí: La mateixa acció en un botó de debò

El control passa a ser un <button type="button">. Rep el focus, el seu esdeveniment click també es llança amb Retorn i amb Espai, i s'anuncia com a botó. Com que obre i tanca un contingut, porta aria-expanded, que indica si està obert.

Proveu-ho aquí:

Mostra el codi de l'exemple correcte
<h2>Oficina d'Atenció Ciutadana</h2>
<button type="button" class="accion" aria-expanded="false" aria-controls="horario" onclick="verHorario(this)">Mostra l'horari d'atenció</button>
<p id="horario" hidden>De dilluns a divendres, de 9.00 a 14.00. Dijous, també de 16.30 a 18.30.</p>
<style>
  h2 { font-size: 1.1em; }
  .accion { display: inline-block; background: #744E9A; color: #fff; border: 0; padding: .5em 1em; font: inherit; cursor: pointer; }
  .accion:focus-visible { outline: 3px solid #0B2239; outline-offset: 2px; }
</style>
<script>
function verHorario(control) {
  var horario = document.getElementById('horario');
  horario.hidden = !horario.hidden;
  control.setAttribute('aria-expanded', String(!horario.hidden));
}
</script>

Com comprovar-ho

Teclat

  1. Recorreu la pàgina amb Tab. El control ha de rebre el focus i el focus s'ha de veure.
  2. Premeu Retorn i després Espai. Les dues tecles han de mostrar o amagar l'horari.
  3. Compareu amb el ratolí: tot el que fa el clic s'ha de poder fer també amb el teclat.

Lector de pantalla (NVDA o VoiceOver)

  1. Situeu el focus en el control. S'ha d'anunciar com a botó i amb el seu estat.
  2. Activeu-lo. L'estat ha de canviar a «expandit».

Hauria d'anunciar: «Mostra l'horari d'atenció, botó, contret»

Eines del navegador

  1. Obriu les eines del navegador (F12), pestanya Elements. Busqueu atributs onclick o escoltadors de clic (tauler «Event Listeners») en elements div, span, li o img.
  2. A la pestanya Accessibilitat, comproveu que cada element amb acció té funció de botó o d'enllaç i rep el focus.

Validació automàtica

  1. axe DevTools, WAVE i Lighthouse no detecten bé un div amb onclick. No saben si un element té escoltadors d'esdeveniments.
  2. Per això la prova amb teclat és imprescindible per al criteri 2.1.1. Les eines automàtiques només ajuden si l'element ja té una funció ARIA sense nom o sense tabindex.

Errors freqüents en auditories

  • Utilitzar div o span amb onclick com a botons: no reben el focus ni responen a Retorn o Espai.
  • Afegir tabindex="0" a un div clicable sense programar Retorn i Espai: rep el focus, però no fa res.
  • Utilitzar un enllaç a sense href per llançar scripts: sense href no rep el focus ni s'activa amb teclat.
  • Llançar l'acció amb mousedown o mouseup en lloc de click: el teclat no dispara aquests esdeveniments.
Veure el text complet del W3C (traducció al català)

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

Scripts utilitzats amb HTML.

Descripció

L'objectiu d'aquesta tècnica és mostrar com invocar una funció de script de manera accessible per teclat, associant-la a un control accessible per teclat. Per garantir que les accions de script es puguin invocar des del teclat, s'associen a elements HTML «accionables de manera nativa» (enllaços i botons). L'esdeveniment onclick d'aquests elements és independent del dispositiu. Encara que «onclick» sembla que estigui lligat al ratolí, en realitat l'esdeveniment onclick està associat a l'acció predeterminada d'un enllaç o d'un botó. L'acció predeterminada es produeix quan l'usuari fa clic en l'element amb el ratolí, però també quan l'usuari situa el focus en l'element i prem Retorn o Espai, i quan l'element s'activa a través de l'API d'accessibilitat.

Aquesta tècnica depèn dels scripts del costat del client. No obstant això, és beneficiós proporcionar una implementació alternativa o una explicació per als entorns en què els scripts no estiguin disponibles. Quan s'utilitzen elements d'ancoratge per invocar una acció JavaScript, la implementació alternativa o l'explicació es proporciona mitjançant l'atribut href. Quan s'utilitzen botons, es proporciona mitjançant l'enviament d'un formulari.

Exemples

Enllaç que executa un script i no té alternativa per a navegadors sense scripts

Aquest enfocament només s'ha d'utilitzar quan es confia en els scripts com a tecnologia compatible amb l'accessibilitat.

Encara que no volem navegar des d'aquest enllaç, hem d'utilitzar l'atribut href en l'element a perquè sigui un enllaç de debò i obtingui el tractament d'esdeveniments adequat. En aquest cas utilitzem href="#" com a destinació de l'enllaç, però s'hi podria posar qualsevol cosa. Mai no es navegarà per aquest enllaç.

El «return false;» al final de la funció de gestió d'esdeveniments doStuff() indica al navegador que no navegui a l'URI. Sense això, la pàgina es tornaria a carregar després d'executar-se el script.

<script>
  function doStuff() {
    //do stuff
    return false;
  }
</script>
<a href="#" onclick="return doStuff();">do stuff</a>

Enllaç que executa un script, però navega a una altra pàgina quan els scripts no estan disponibles

Aquest enfocament es pot utilitzar per crear llocs que no depenguin dels scripts, sempre que la destinació de la navegació ofereixi la mateixa funcionalitat que el script. Aquest exemple és idèntic a l'exemple 1, excepte que ara el seu href apunta a una pàgina real, dostuff.html. La pàgina dostuff.html ha d'oferir la mateixa funcionalitat que el script. El «return false;» al final de la funció de gestió d'esdeveniments doStuff() indica al navegador que no navegui a l'URI. Sense això, el navegador navegaria a dostuff.html després d'executar-se el script.

<script>
  function doStuff() {
  //do stuff
  return false;
}
</script>
<a href="dostuff.html" onclick="return doStuff();">do stuff</a>

Hi ha disponible un exemple funcional d'aquest codi. Consulteu Creating Action Links using JavaScript (crear enllaços d'acció amb JavaScript).

Botó que executa un script i recorre a l'enviament d'un formulari per als usuaris sense scripts

Aquest enfocament el poden utilitzar els llocs que no depenen dels scripts, sempre que l'enviament del formulari ofereixi la mateixa funcionalitat que el script. L'onsubmit="return false;" impedeix que s'enviï el formulari.

<script>
function doStuff() {
  //do stuff
}
</script>
<form action="doStuff.aspx" onsubmit="return false;">
  <input type="submit" value="Do Stuff" onclick="doStuff();">
</form>

Hi ha disponible un exemple funcional d'aquest codi. Consulteu Creating Action Buttons using JavaScript (crear botons d'acció amb JavaScript).

Botó que executa un script, implementat amb input type="image"

Tingueu en compte que cal afegir un atribut alt a l'input per proporcionar un equivalent textual de la imatge. Aquest enfocament només s'ha d'utilitzar quan es confia en els scripts.

<script>
function doStuff() {
  //do stuff
  return false;
}
</script>
<input type="image" src="stuff.gif" alt="Do stuff" onclick="return doStuff();">

Botó que executa un script, implementat amb input type="submit", input type="reset" o input type="button"

Aquest enfocament només s'ha d'utilitzar quan es confia en els scripts.

<input type="submit" onclick="return doStuff();" value="Do Stuff">

Botó que executa un script, implementat amb button

Això és útil quan es vol més control sobre l'aspecte del botó. En aquest exemple concret, el botó conté tant una icona com text. Aquest enfocament només s'ha d'utilitzar quan es confia en els scripts.

<button onclick="return doStuff();">
  <img src="stuff.gif" alt="stuff icon">
  Do Stuff
</button>

Proves

Procediment

Per a totes les accions de script associades a elements a, button o input:

  1. En un agent d'usuari compatible amb scripts

    • Fer clic en el control amb el ratolí.
    • Comprovar que l'acció del script s'executa correctament.
    • Si el control és un element d'ancoratge, comprovar que no s'invoca l'URI de l'atribut href de l'element d'ancoratge.
    • Comprovar que és possible navegar fins al control i donar-li el focus mitjançant el teclat.
    • Situar el focus del teclat en el control.
    • Comprovar que en prémer RETORN s'invoca l'acció del script.
    • Si el control és un element d'ancoratge, comprovar que no s'invoca l'URI de l'atribut href de l'element d'ancoratge.
  2. En un agent d'usuari no compatible amb scripts

    • Fer clic en el control amb el ratolí.
    • Si el control és un element d'ancoratge, comprovar que s'invoca l'URI de l'atribut href de l'element d'ancoratge.
    • Comprovar que és possible navegar fins al control i donar-li el focus mitjançant el teclat.
    • Situar el focus del teclat en el control.
    • Si el control és un element d'ancoratge, comprovar que en prémer RETORN s'invoca l'URI de l'atribut href de l'element d'ancoratge.

Resultats esperats

  • Totes les comprovacions anteriors 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 SCR35 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.