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

Error habitual WCAG 2.2

F55Scripts que treuen el focus a un element tan bon punt el rep

Nom oficial al W3C: Error dels criteris de conformitat 2.1.1, 2.4.7, 2.4.13 i 3.2.1 per utilitzar scripts per treure el focus quan es rep

Versión en castellano

En poques paraules

Alguns scripts criden blur() quan un enllaç o un botó rep el focus, perquè no es vegi el requadre que el marca. L'element perd el focus a l'instant i no es pot utilitzar amb el teclat. Si el requadre no agrada, se'n canvia l'aspecte amb CSS, però no es treu mai.

Per què és important

El focus és la marca que indica en quin element és la persona quan navega amb el teclat. Qui no utilitza el ratolí en depèn per orientar-se i per activar enllaços i botons.

Si un script treu el focus tan bon punt arriba, l'element no respon a Retorn ni a Espai. La persona no veu on és, i el lector de pantalla es pot quedar callat o tornar a l'inici. El control només funciona amb el ratolí.

Com evitar-ho

  1. No utilitzeu blur() en els esdeveniments focus o focusin.
  2. Si el contorn del focus no encaixa amb el disseny, canvieu-lo amb CSS. Utilitzeu :focus-visible, que només el mostra quan es navega amb el teclat.
  3. Feu que el nou indicador es vegi bé: amb prou gruix i bon contrast amb el fons.
  4. Tampoc no utilitzeu outline: none sense posar-hi un altre indicador en el seu lloc.
  5. Reviseu connectors, carrusels i menús de tercers, que de vegades inclouen aquest truc.

Exemple pràctic

Apareix en botons d'eines, carrusels i menús. Per amagar el contorn del focus, un script crida blur() tan bon punt el control rep el focus.

Així no: Botons que perden el focus en rebre'l

Cada botó executa this.blur() en l'esdeveniment focus. Amb el ratolí funcionen. Però quan s'hi arriba amb Tab, el focus desapareix a l'instant: no es veu on és, i Retorn o Espai no activen res. Amb NVDA en mode d'exploració pot semblar que funciona, així que cal provar-ho amb Tab.

Captura de pantalla de l'exemple incorrecte: Botons que perden el focus en rebre'l
Així es veu l'exemple incorrecte.

La demostració conté, expressament, l'error d'accessibilitat que s'explica.

Veure el codi de l'exemple incorrecte
<style>
  .herramientas button { background: #744E9A; color: #FFFFFF; border: 0; padding: 8px 12px; border-radius: 4px; font-size: 1rem; cursor: pointer; }
</style>
<div class="herramientas">
  <button type="button" onfocus="this.blur()" onclick="cambiar(-2)">Reduir el text</button>
  <button type="button" onfocus="this.blur()" onclick="cambiar(2)">Ampliar el text</button>
</div>
<p id="texto" style="font-size: 16px">El termini d'inscripció a les escoles esportives municipals acaba el 30 d'octubre.</p>
<script>
  function cambiar(px) {
    const p = document.getElementById('texto');
    const nuevo = parseInt(p.style.fontSize, 10) + px;
    p.style.fontSize = Math.min(26, Math.max(12, nuevo)) + 'px';
  }
</script>

Així sí: Botons que conserven el focus amb un indicador propi

Es treu onfocus="this.blur()". Si el contorn predeterminat no encaixa amb el disseny, se substitueix per un de propi amb :focus-visible, que només apareix quan es navega amb el teclat. El focus es queda al botó fins que l'usuari el mou.

Proveu-ho aquí:

Veure el codi de l'exemple correcte
<style>
  .herramientas button { background: #744E9A; color: #FFFFFF; border: 0; padding: 8px 12px; border-radius: 4px; font-size: 1rem; cursor: pointer; }
  .herramientas button:focus-visible { outline: 3px solid #0B2239; outline-offset: 2px; }
</style>
<div class="herramientas">
  <button type="button" onclick="cambiar(-2)">Reduir el text</button>
  <button type="button" onclick="cambiar(2)">Ampliar el text</button>
</div>
<p id="texto" style="font-size: 16px">El termini d'inscripció a les escoles esportives municipals acaba el 30 d'octubre.</p>
<script>
  function cambiar(px) {
    const p = document.getElementById('texto');
    const nuevo = parseInt(p.style.fontSize, 10) + px;
    p.style.fontSize = Math.min(26, Math.max(12, nuevo)) + 'px';
  }
</script>

Com comprovar-ho

Teclat

  1. Recórrer tots els elements interactius amb Tab i Maj+Tab.
  2. En arribar a cadascun, esperar un moment sense tocar res. Comprovar que el focus s'hi manté.
  3. Prémer Retorn o Espai i comprovar que el control s'activa.

Lector de pantalla (NVDA o VoiceOver)

  1. Arribar a cada botó amb Tab, no amb les fletxes del mode d'exploració.
  2. Comprovar que el lector anuncia el control. No s'ha de quedar en silenci ni tornar a llegir el document.

Hauria d'anunciar: «Ampliar el text, botó»

Eines del navegador

  1. Obrir les eines de desenvolupament (F12). A la Consola, crear una expressió en directe (icona de l'ull) amb document.activeElement.
  2. Navegar amb Tab. L'expressió ha de mostrar el botó, no body.
  3. A Elements > Detectors d'esdeveniments, cercar gestors de focus o focusin que cridin blur().

Validació automàtica

  1. axe DevTools, WAVE i Lighthouse no detecten aquest error. Depèn del que fa l'script mentre s'utilitza la pàgina.
  2. Com a suport, cercar al codi blur() dins de gestors de focus, mousedown o click.

Errors freqüents en auditories

  • Posar onfocus="this.blur()" als enllaços de carrusels o pestanyes per amagar el contorn del focus.
  • Cridar blur() després de cada clic per treure el contorn. Amb el teclat, el focus torna a l'inici del document després d'activar el botó.
  • Camps de només lectura o de data que executen blur() en rebre el focus, perquè no surti el teclat del mòbil. Així no s'hi pot arribar amb Tab.
  • Menús desplegables l'script dels quals mou el focus a un altre element tan bon punt un enllaç el rep.
Veure el text complet del W3C (traducció al català)

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

Notes sobre la compatibilitat amb agents d'usuari i tecnologies de suport

  • No se n'indica cap.

Descripció

El contingut que normalment rep el focus quan s'hi accedeix amb el teclat el pot perdre per l'acció d'un script. De vegades es fa perquè qui dissenya considera que l'indicador del focus del sistema és poc estètic. Tanmateix, l'indicador del focus del sistema és una part important de l'accessibilitat per a qui utilitza el teclat. A més, aquesta pràctica treu el focus del contingut completament, la qual cosa vol dir que el contingut només es pot fer servir amb un dispositiu apuntador com el ratolí.

Exemples

<input type="submit" onFocus="this.blur();">
<a onFocus="this.blur()" href="Page.html"><img src="myImage.gif"></a>
<a href="link.html" onfocus="if(this.blur)this.blur();">Link Phrase</a>

Proves

Procediment

  1. Utilitzar el teclat per verificar que es pot arribar a tots els elements interactius mitjançant el teclat.
  2. Comprovar que, quan el focus se situa en cada element, el focus hi roman fins que l'usuari el mou.

Resultats esperats

  • Si la comprovació núm. 2 és falsa, es dona aquesta condició d'error i el contingut no compleix el criteri de conformitat.

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