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

Tècnica Scripts de client WCAG 2.2

SCR31Ressaltar amb JavaScript l'element que té el focus

Nom oficial al W3C: Utilitzar scripts per canviar el color de fons o la vora de l'element que té el focus

Versión en castellano

En poques paraules

El focus és la marca que indica quin element està actiu quan es navega amb teclat. Aquesta tècnica utilitza JavaScript per canviar el fons o la vora d'enllaços, botons i camps quan reben el focus, i ho treu quan el perden. Així l'indicador es veu molt millor. Avui sol n'hi ha prou amb CSS, utilitzant :focus o :focus-visible.

Per què és important

Qui navega amb teclat necessita veure en tot moment on és. El contorn que posa el navegador per defecte de vegades és fi, gris o gairebé invisible sobre certs fons.

Sense un focus visible, la persona no sap quin enllaç s'activarà quan premi Retorn. És com fer servir el ratolí sense veure el punter.

Com es fa

  1. Escolteu els esdeveniments focusin i focusout (o focus i blur a cada element).
  2. Quan un element rebi el focus, afegiu-li una classe que canviï el fons, la vora o el contorn amb un bon contrast.
  3. Quan el perdi, traieu la classe perquè recuperi el seu aspecte habitual.
  4. Apliqueu-ho a tots els elements interactius: enllaços, botons, camps i controls personalitzats.
  5. Avui el més senzill és fer-ho només amb CSS, per exemple a:focus-visible { outline: 3px solid #000; }. Utilitzeu l'script quan necessiteu més control.

Com comprovar-ho

  1. Recorreu tota la pàgina amb la tecla Tab, de principi a fi.
  2. A cada parada, comproveu que es veu amb claredat quin element té el focus.
  3. Premeu Maj + Tab per retrocedir. El ressaltat ha de desaparèixer de l'element que perd el focus.
  4. Reviseu-ho sobre fons clars i foscos, com la capçalera o el peu de pàgina.

Exemple

Fons groc i contorn negre en qualsevol element que rep el focus.

<style>
  .con-foco { background: #ffd200; outline: 2px solid #000; }
</style>
<script>
document.addEventListener('focusin', function (e) {
  e.target.classList.add('con-foco');
});
document.addEventListener('focusout', function (e) {
  e.target.classList.remove('con-foco');
});
</script>
Veure el text complet del W3C (traducció al català)

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

Descripció

El propòsit d'aquesta tècnica és permetre que l'autor utilitzi JavaScript per aplicar CSS, a fi de fer l'indicador del focus més visible del que seria normalment. Quan un element rep el focus, se'n canvia el color de fons o la vora per distingir-lo visualment. Quan l'element perd el focus, recupera el seu estil habitual. Aquesta tècnica es pot utilitzar en qualsevol agent d'usuari HTML compatible amb scripts i CSS, independentment que admeti o no la pseudoclasse :focus.

Exemples

En aquest exemple, quan l'enllaç rep el focus, el seu fons es torna groc. Quan perd el focus, s'elimina el groc. Tingueu en compte que, si l'enllaç tingués un color de fons de partida, a l'script s'utilitzaria aquest color en lloc de "".

<script>function toggleFocus(el) {
  el.style.backgroundColor =  el.style.backgroundColor=="yellow" ? "inherit" : "yellow";
}
</script>
...
<a href="example.html" 
 onfocus="toggleFocus(this)" onblur="toggleFocus(this)">focus me</a>
...

Proves

Procediment

  1. Recórrer amb la tecla de tabulació cada element de la pàgina.
  2. Comprovar que l'indicador del focus és visible.

Resultats esperats

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

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