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

Tècnica CSS WCAG 2.2

C45Mostrar el focus del teclat amb la pseudoclasse :focus-visible

Nom oficial al W3C: Utilitzar la pseudoclasse CSS :focus-visible per indicar el focus del teclat

Versión en castellano

En poques paraules

El focus és la marca que indica quin element s'activarà en prémer Retorn. Amb la pseudoclasse CSS :focus-visible se li dona un estil molt visible quan es navega amb el teclat. En fer clic amb el ratolí, el navegador normalment no el mostra. Així ja no hi ha motiu per eliminar l'indicador perquè «molesta».

Per què és important

Qui utilitza només el teclat avança amb Tab per enllaços, botons i camps. Si no veu el focus, no sap on és. És com utilitzar el ratolí sense veure'n el punter.

Molts webs treuen el contorn amb outline: none perquè apareix en fer clic i no agrada. Amb :focus-visible no cal triar: el contorn es veu amb el teclat i no fa nosa amb el ratolí. El criteri 2.4.7 (nivell AA) demana que el focus del teclat sigui visible.

Com es fa

  1. Cerqueu les regles outline: none que no tinguin alternativa i elimineu-les.
  2. Definiu un estil per a :focus-visible. Per exemple, outline: 3px solid #0B2239 i outline-offset: 3px.
  3. Trieu un color que contrasti amb el fons i amb el mateix element. Un contorn d'1 píxel o d'un color pàl·lid no serveix.
  4. Apliqueu-lo a tot el que pot rebre el focus: enllaços, botons, camps, menús i components amb tabindex.
  5. En els camps de text, l'estil apareix també en fer clic. És el que s'espera, perquè després s'escriu amb el teclat.

Exemple pràctic

En les fitxes de producte, l'equip de disseny sol demanar que es tregui l'anell de focus dels botons perquè «apareix en fer clic». La pseudoclasse :focus-visible resol el conflicte. Mostra un indicador clar a qui navega amb teclat i, en general, no el mostra en fer clic amb el ratolí.

Així no: S'elimina el contorn amb :focus

La regla .btn:focus { outline: none; } treu l'indicador sempre, també en navegar amb Tab. Així no se sap quin botó té el focus. Premeu Tab dins de l'exemple per notar-ho.

Captura de pantalla de l'exemple incorrecte: S'elimina el contorn amb :focus
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
<style>
  .btn { font: inherit; padding: 10px 18px; margin-right: 8px; border: 0; border-radius: 6px; background: #744E9A; color: #fff; cursor: pointer; }
  .btn:focus { outline: none; }
</style>
<h2>Sabatilles de muntanya Sierra</h2>
<p>89,90 € · Enviament gratuït</p>
<button type="button" class="btn">Afegeix a la cistella</button>
<button type="button" class="btn">Desa als preferits</button>

Així sí: Indicador ben visible amb :focus-visible

La regla passa a ser .btn:focus-visible, amb un contorn de 3 px en #0B2239 separat del botó. Aquest color contrasta molt amb el fons blanc. En prémer Tab es veu clarament quin botó té el focus. En fer clic amb el ratolí, normalment el navegador no el mostra.

Proveu-ho aquí:

Mostra el codi de l'exemple correcte
<style>
  .btn { font: inherit; padding: 10px 18px; margin-right: 8px; border: 0; border-radius: 6px; background: #744E9A; color: #fff; cursor: pointer; }
  .btn:focus-visible { outline: 3px solid #0B2239; outline-offset: 3px; }
</style>
<h2>Sabatilles de muntanya Sierra</h2>
<p>89,90 € · Enviament gratuït</p>
<button type="button" class="btn">Afegeix a la cistella</button>
<button type="button" class="btn">Desa als preferits</button>

Com comprovar-ho

Teclat

  1. Recorreu la pàgina amb Tab i Maj+Tab, sense utilitzar el ratolí.
  2. Comproveu que cada enllaç, botó i camp mostra un indicador del focus visible. S'ha de distingir bé de l'estat normal i de l'estat en passar el ratolí («hover»).
  3. Feu clic amb el ratolí en un botó i premeu després Tab. L'indicador ha d'aparèixer tan bon punt s'utilitza el teclat.

Eines del navegador

  1. Obriu les eines del navegador (F12) i seleccioneu el botó. A la pestanya «Estils», utilitzeu «:hov» per forçar els estats :focus i :focus-visible.
  2. Comproveu que hi ha una regla amb estils visibles per a :focus-visible (o per a :focus). Cap regla posterior no ha d'aplicar outline: none sense donar cap altra alternativa.
  3. Cerqueu als fulls d'estils outline: none i outline: 0, i reviseu cada cas.

Validació automàtica

  1. axe DevTools, WAVE i Lighthouse no comproven si l'indicador del focus es veu. Lighthouse ho deixa com a revisió manual.
  2. La comprovació sempre és manual, amb el teclat.

Errors freqüents en auditories

  • Reinicis de CSS o temes amb *:focus { outline: none; }, que deixen tot el web sense indicador del focus.
  • Indicadors d'1 px o d'un color gairebé igual al del fons. Existeixen, però no es distingeixen.
  • Definir :focus-visible només per als botons i oblidar enllaços, camps de formulari i components propis amb tabindex.
  • Marcar el focus només amb un canvi de color del text, sense contorn ni subratllat. És difícil de percebre.
Veure el text complet del W3C (traducció al català)

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

Totes les tecnologies que admeten CSS.

Descripció

L'objectiu d'aquesta tècnica és proporcionar estils personalitzats als elements interactius quan reben el focus del teclat. En aquest exemple, això s'aconsegueix mitjançant la pseudoclasse CSS :focus-visible.

Els estils definits amb la pseudoclasse habitual :focus s'apliquen sempre que un element té el focus, amb independència de com l'hagi rebut. En canvi, els agents d'usuari apliquen heurístiques i lògica addicionals per decidir quan mostrar els estils de :focus-visible; en particular, els navegadors sempre mostren aquests estils quan l'usuari navega amb el teclat, però en general no els mostren com a resultat d'una interacció amb el ratolí o el punter (amb l'excepció dels elements que també admeten entrada per teclat, com els elements <input>). Això permet als autors oferir una indicació visible del focus molt marcada als usuaris de teclat, sense imposar-la als usuaris de ratolí o punter, que potser no la volen ni la necessiten (per exemple, perquè els distreu visualment).

Això satisfà el requisit de proporcionar un mode de funcionament en què l'indicador del focus del teclat sigui visible.

Aquesta tècnica només és suficient si utilitza estils que proporcionin un indicador del focus visible.

Hi pot haver situacions en què els usuaris de ratolí o punter també es beneficiïn de disposar d'un indicador del focus visible, encara que no hagin donat el focus a un element amb el teclat. Tot i que no és un requisit normatiu, els autors haurien de plantejar-se igualment proporcionar un estil :focus explícit per a aquests casos.

Exemples

Utilitzar CSS :focus-visible per indicar el focus del teclat

En aquest exemple tenim un control <button> estàndard a l'HTML.

De manera predeterminada, en tots els navegadors moderns, aquest botó no mostra cap indicació del focus quan s'activa amb el ratolí o el punter. Els navegadors mostren el seu contorn o indicació del focus predeterminats quan l'usuari dona el focus al botó amb Tab.

Per fer més destacada aquesta indicació del focus, utilitzem el selector de pseudoclasse :focus-visible per definir un estil de focus més deliberat i pronunciat.

Exemple pràctic: Utilitzar CSS :focus-visible per indicar el focus del teclat.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width,
              initial-scale=1, shrink-to-fit=no">
  <title>Using CSS :focus-visible to
         provide keyboard focus indication</title>
  <style>
    /* Specific :focus-visible styles */
    :focus-visible {
      outline: 5px solid red;
    }
    …
  </style>
</head>
<body>
  …
  <button>Example button</button>
  …
</body>
</html>

Proves

Procediment

Per a cada component de la interfície d'usuari que pugui rebre el focus del teclat:

  1. Donar el focus al component de la interfície amb el teclat (en general, navegant fins al component amb Tab/Shift+Tab).
  2. Comprovar que, un cop el component ha rebut el focus, hi ha un indicador del focus visible.

Resultats esperats

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

Recursos

  1. CSS Selectors Level 4 - :focus-visible pseudo-class (especificació de la pseudoclasse).
  2. MDN - :focus-visible pseudo-class (documentació de referència).

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