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

Error habitual WCAG 2.2

F78Treure o amagar amb CSS l'indicador del focus

Nom oficial al W3C: Error dels criteris de conformitat 1.4.11, 2.4.7 i 2.4.13 per aplicar estils als contorns i les vores dels elements de manera que eliminen l'indicador visual del focus o el fan invisible

Versión en castellano

En poques paraules

En navegar amb el teclat, el navegador marca amb un contorn l'element actiu. Aquest element actiu s'anomena focus. L'error consisteix a treure aquest contorn amb CSS, o a tapar-lo amb vores semblants, sense posar al seu lloc un altre indicador ben visible.

Per què és important

Moltes persones no fan servir ratolí. Per exemple, persones amb problemes de mobilitat que utilitzen el teclat o un polsador. Sense indicador del focus no saben on són. És com escriure sense veure el cursor.

Premen Retorn sense saber quin enllaç obriran. En un formulari de cita prèvia poden escriure en el camp equivocat o enviar-lo sense voler.

Com evitar-ho

  1. No utilitzeu outline: none ni outline: 0 sense definir un altre estil de focus.
  2. Si el disseny demana canviar el contorn del navegador, definiu-ne un de propi a :focus-visible. Ha de ser gruixut (2 o 3 px) i tenir un contrast d'almenys 3:1 amb el fons.
  3. No poseu vores ni contorns decoratius que s'assemblin a l'indicador del focus.
  4. Eviteu que l'indicador sigui del mateix color que la vora o el fons de l'element. Si cal, separeu-lo amb outline-offset.
  5. Reviseu els fulls d'estils del tema, del reset i dels connectors. Sovint és allà on s'amaga la regla que treu el focus.

Exemple pràctic

És l'error més repetit en menús, botons i targetes. Una regla outline: none treu l'indicador del focus i no se'n posa cap altre al seu lloc. Sovint ve d'un full de reset o del tema.

Així no: Menú amb outline: none i sense cap altre indicador

La regla .menu a:focus { outline: none; } treu el contorn del navegador. No hi ha cap altre estil de focus. En prémer Tab, el focus avança pel menú, però no es veu en quin enllaç és.

Captura de pantalla de l'exemple incorrecte: Menú amb outline: none i sense cap altre indicador
Així es veu l'exemple incorrecte.

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

Veure el codi de l'exemple incorrecte
<style>
  .menu { display: flex; flex-wrap: wrap; gap: 12px; list-style: none; padding: 0; }
  .menu a { color: #412c56; font-weight: bold; text-decoration: none; padding: 6px 8px; border-radius: 4px; }
  .menu a:hover { text-decoration: underline; }
  .menu a:focus { outline: none; }
</style>
<nav aria-label="Principal">
  <ul class="menu">
    <li><a href="#">Inici</a></li>
    <li><a href="#">Tràmits</a></li>
    <li><a href="#">Cita prèvia</a></li>
    <li><a href="#">Contacte</a></li>
  </ul>
</nav>

Així sí: Menú amb un indicador del focus propi

Es canvia outline: none per un contorn propi a :focus-visible. Fa 3 px, és lila (#744E9A) i té un contrast de 6,4:1 amb el fons blanc. outline-offset el separa del text. En utilitzar el teclat, el focus sempre es veu.

Proveu-ho aquí:

Veure el codi de l'exemple correcte
<style>
  .menu { display: flex; flex-wrap: wrap; gap: 12px; list-style: none; padding: 0; }
  .menu a { color: #412c56; font-weight: bold; text-decoration: none; padding: 6px 8px; border-radius: 4px; }
  .menu a:hover { text-decoration: underline; }
  .menu a:focus-visible { outline: 3px solid #744E9A; outline-offset: 2px; }
</style>
<nav aria-label="Principal">
  <ul class="menu">
    <li><a href="#">Inici</a></li>
    <li><a href="#">Tràmits</a></li>
    <li><a href="#">Cita prèvia</a></li>
    <li><a href="#">Contacte</a></li>
  </ul>
</nav>

Com comprovar-ho

Teclat

  1. Prémer Tab des del principi de la pàgina i recórrer tots els elements que reben el focus.
  2. Comprovar en cadascun que es veu bé quin té el focus. Revisar també els fons de color, les imatges i les targetes.
  3. Repetir cap enrere amb Maj+Tab per trobar elements en què l'indicador desapareix.

Eines del navegador

  1. Obrir les eines de desenvolupament (F12) i seleccionar l'element. Al tauler Estils, prémer el botó :hov i activar l'estat :focus-visible.
  2. A la pestanya Calculat (Computed), comprovar que outline-style no és none. Si ho és, hi ha d'haver un altre canvi visible: vora, fons o ombra.
  3. Cercar als fulls d'estils les regles outline: none o outline: 0. Cadascuna ha de tenir una alternativa.

Validació automàtica

  1. axe DevTools i WAVE no detecten que falti l'indicador del focus. No naveguen amb el teclat ni comparen estats.
  2. Lighthouse només ho inclou entre les comprovacions manuals, que no puntuen. Per això la revisió amb teclat és imprescindible.

Errors freqüents en auditories

  • Fulls de reset o temes de WordPress amb *:focus { outline: none; } o a:focus { outline: 0; }, que afecten tot el web.
  • Canviar el contorn per un box-shadow i posar outline: none. En el mode de colors forçats de Windows l'ombra desapareix i el focus deixa de veure's.
  • Un indicador del mateix color que el fons del botó o de la capçalera. Existeix en el codi, però no es distingeix.
  • Vores decoratives en enllaços i targetes iguals al contorn del focus. No se sap quin element té el focus.
Veure el text complet del W3C (traducció al català)

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

Qualsevol tecnologia

Descripció

Descriu una condició d'error que es produeix quan la indicació visual predeterminada del focus del teclat que ofereix l'agent d'usuari es desactiva o esdevé invisible a causa d'altres estils de la pàgina, sense que l'autor proporcioni un indicador visual del focus propi. Desactivar l'indicador del focus indica a l'agent d'usuari que no presenti l'indicador del focus. Altres estils poden dificultar que es vegi l'indicador del focus encara que hi sigui, com ara contorns que tenen el mateix aspecte que el contorn del focus, o vores gruixudes del mateix color que l'indicador del focus, de manera que no s'hi pot distingir a sobre.

Exemples

L'indicador del focus es desactiva amb CSS

L'exemple de CSS següent elimina l'indicador del focus predeterminat, cosa que incompleix el requisit de proporcionar un indicador del focus visible.

:focus {outline: none}

El contorn dels elements és visualment semblant a l'indicador del focus

L'exemple de CSS següent crea al voltant dels enllaços un contorn que té el mateix aspecte que l'indicador del focus. Això fa impossible que els usuaris determinin quin d'ells té realment el focus, encara que l'agent d'usuari sí que dibuixi l'indicador del focus.

a {outline: thin dotted black}

Els elements tenen una vora que tapa l'indicador del focus

L'exemple de CSS següent crea al voltant dels enllaços una vora que no té prou contrast perquè l'indicador del focus es vegi quan es dibuixa a sobre. En aquest cas, l'indicador del focus es dibuixa just per fora de la vora, però com que tots dos són negres i la vora és més gruixuda que l'indicador del focus, aquest ja no compleix la definició de «visible».

a {border: medium solid black}

Proves

Procediment

  1. Situar el focus, mitjançant el teclat, en tots els elements enfocables 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

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