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

Tècnica CSS WCAG 2.2

C40Crear un indicador de focus de dos colors que es vegi sobre qualsevol fons

Nom oficial al W3C: Crear un indicador del focus de dos colors per garantir un contrast suficient amb tots els components

Versión en castellano

En poques paraules

L'indicador de focus és el requadre que marca quin element està seleccionat amb el teclat. Si es dibuixa amb dos colors molt diferents, un de clar i un altre de fosc, sempre se'n veurà almenys un. Així serveix el mateix estil per a fons blancs, de color i foscos.

Per què és important

Qui navega amb teclat necessita veure en tot moment on és. Un focus d'un sol color es pot veure bé sobre blanc i desaparèixer sobre una franja del mateix to.

Crear un estil diferent per a cada fons porta temps i és fàcil oblidar-ne algun. Un focus de dos colors resol el problema d'una vegada a tot el web.

Com es fa

  1. Trieu dos colors amb un contrast entre ells d'almenys 9:1, per exemple blanc i blau marí. Així un dels dos tindrà sempre almenys 3:1 amb qualsevol fons llis.
  2. Dibuixeu una banda amb outline i l'altra amb box-shadow, dins de :focus-visible o :focus.
  3. Doneu a cada banda almenys 2 píxels de gruix.
  4. No utilitzeu outline: none per deixar només l'ombra: en el mode d'alt contrast de Windows les ombres desapareixen.
  5. Dibuixeu l'indicador fora del component i sobre fons llis. Sobre imatges o degradats cal revisar el contrast a mà.

Exemple pràctic

Serveix per a webs amb franges de colors diferents, com portades d'ajuntaments, pàgines de producte o landings. Un únic estil de focus de dos colors es veu sobre fons clars, de color i foscos. No cal crear una classe per a cada secció.

Així no: Focus d'un sol color que desapareix en algunes franges

Tots els enllaços utilitzen un contorn lila #744E9A de 3 px. Sobre la franja blanca es veu bé (6,4:1). Sobre la franja lila, el contrast és 1:1, i sobre la fosca #0B2239, 2,5:1. El focus no es distingeix en dues de les tres seccions.

Captura de pantalla de l'exemple incorrecte: Focus d'un sol color que desapareix en algunes franges
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>
  .franja { padding: 16px; }
  .clara { background: #FFFFFF; color: #412c56; }
  .lila { background: #744E9A; color: #FFFFFF; }
  .oscura { background: #0B2239; color: #FFFFFF; }
  .franja a { color: inherit; font-weight: bold; }
  a:focus-visible { outline: 3px solid #744E9A; outline-offset: 3px; }
</style>
<div class="franja clara"><a href="#">Veure els tràmits en línia</a></div>
<div class="franja lila"><a href="#">Demanar cita prèvia</a></div>
<div class="franja oscura"><a href="#">Contactar amb l'ajuntament</a></div>

Així sí: Focus de dos colors amb outline i box-shadow

L'indicador combina dues bandes de 2 px: una interior blanca (outline) i una altra exterior #0B2239 (box-shadow). Entre elles tenen un contrast de 16,1:1, superior a 9:1. Per això una de les dues arriba sempre a 3:1 amb qualsevol fons llis. Com que es manté l'outline, el focus continua veient-se en el mode de colors forçats, que elimina les ombres.

Proveu-ho aquí:

Mostra el codi de l'exemple correcte
<style>
  .franja { padding: 16px; }
  .clara { background: #FFFFFF; color: #412c56; }
  .lila { background: #744E9A; color: #FFFFFF; }
  .oscura { background: #0B2239; color: #FFFFFF; }
  .franja a { color: inherit; font-weight: bold; }
  a:focus-visible { outline: 2px solid #FFFFFF; outline-offset: 0; box-shadow: 0 0 0 4px #0B2239; }
</style>
<div class="franja clara"><a href="#">Veure els tràmits en línia</a></div>
<div class="franja lila"><a href="#">Demanar cita prèvia</a></div>
<div class="franja oscura"><a href="#">Contactar amb l'ajuntament</a></div>

Com comprovar-ho

Teclat

  1. Recorreu amb Tab els components de cada fons de la pàgina: clars, de color i foscos.
  2. Comproveu que en tots es distingeix almenys una de les dues bandes de l'indicador.

Eines del navegador

  1. Obriu les eines de desenvolupament (F12) i seleccioneu un enllaç. Activeu :focus-visible amb el botó :hov del tauler Estils.
  2. A Calculat (Computed), reviseu els colors i els gruixos d'outline i box-shadow. Cada banda ha de mesurar almenys 2 px. Els dos colors han de tenir entre ells un contrast de 9:1 o més.
  3. Al tauler Renderització (Rendering), emuleu forced-colors: active. Comproveu que l'indicador continua visible encara que desaparegui l'ombra.

Validació automàtica

  1. axe DevTools, WAVE i Lighthouse no analitzen els estils de focus ni el seu contrast. No detecten un indicador que es perd sobre un fons concret.
  2. Calculeu a mà el contrast entre els dos colors amb un analitzador de contrast. Reviseu la visibilitat sobre cada fons real de la pàgina, sobretot si hi ha imatges o degradats.

Errors freqüents en auditories

  • Utilitzar només box-shadow amb outline: none. En el mode de colors forçats de Windows l'ombra desapareix i no queda cap indicador.
  • Triar dos colors amb poc contrast entre ells, per exemple un lila i un blau corporatius. Així no es garanteix el 3:1 sobre qualsevol fons.
  • Utilitzar bandes d'1 px, que no arriben al gruix mínim. O utilitzar un outline-offset negatiu que dibuixa l'indicador dins del component, sobre una imatge o un degradat.
  • Deixar que overflow: hidden retalli l'indicador en carrusels i targetes. Només queda visible una banda en part del contorn.
Veure el text complet del W3C (traducció al català)

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

CSS.

Descripció

L'objectiu d'aquesta tècnica és crear un indicador del focus de dos colors que tingui un contrast suficient amb qualsevol color de fons llis. Aquesta tècnica pot evitar la necessitat d'utilitzar diverses classes per garantir un contrast suficient de l'indicador del focus quan es mostra sobre fons diferents.

Els autors poden aplicar aquesta tècnica en llocs que utilitzen diversos colors de fons. Tot i que és possible crear indicadors del focus de colors diferents per a parts diferents d'una pàgina, això pot portar molt de temps i és fàcil passar per alt alguns components. Tanmateix, si l'indicador del focus utilitza dos colors molt contrastats entre ells (un color clar i un color fosc), es pot reutilitzar el mateix indicador, ja que almenys un dels dos colors tindrà sempre prou contrast amb qualsevol color de fons.

Sempre que els dos colors de l'indicador tinguin entre ells una relació de contrast d'almenys 9:1, es garanteix que almenys un dels dos colors arribarà a un contrast de 3:1 amb qualsevol color de fons llis.

Aquesta tècnica només garanteix que l'indicador superarà la comprovació si tot l'indicador es dibuixa sobre el fons, no dins del contorn del component enfocat, i si tot el fons situat darrere de l'indicador és un únic color llis. Per exemple, si el fons és una imatge o un degradat, o si l'indicador se superposa parcialment a un altre component de la interfície d'usuari, pot ser que encara calgui comparar l'indicador píxel a píxel amb el fons.

En CSS, els indicadors de dos colors es poden implementar combinant les propietats outline i box-shadow amb les pseudoclasses :focus o :focus-visible.

Eviteu establir outline: none per utilitzar box-shadow tot sol. Els agents d'usuari solen suprimir la propietat box-shadow en els modes de colors forçats, per la qual cosa els autors haurien d'evitar dependre únicament de box-shadow per implementar els indicadors del focus. Si cal un estil basat només en box-shadow, consideri combinar-lo amb una propietat outline: 2px transparent solid per garantir la compatibilitat amb els modes de colors forçats.

Exemples

Aquest exemple mostra una implementació senzilla en què els estils de focus s'apliquen a tots els components enfocables. En utilitzar-lo en un lloc web més complex, caldria assegurar-se que aquests estils no queden anul·lats per altres estils més específics.

Un indicador gruixut de dos colors

En aquest exemple, l'indicador consta de dues bandes de color llis. Com que cada banda de color té 2 píxels CSS de gruix, qualsevol de les dues bandes és prou gran per complir tota sola el requisit de mida mínima de l'indicador. Sempre que un dels dos colors tingui un contrast de canvi de 3:1 amb els píxels situats darrere i al voltant de l'indicador del focus, l'indicador complirà tant el criteri de conformitat Aparença del focus com el de Contrast no textual.

*:focus {
	/* inner indicator */
	outline: 2px #F9F9F9 solid;
	outline-offset: 0;
	/* outer indicator */
	box-shadow: 0 0 0 4px #193146;
}

Exemple pràctic d'un indicador gruixut de dos colors

Proves

Procediment

Per a cada component de la interfície d'usuari enfocable:

  1. Comprovar que els dos colors de l'indicador del focus tenen entre ells una relació de contrast de 9:1 o superior.
  2. Comprovar que cada banda de color té almenys 2 píxels CSS de gruix.
  3. Comprovar que l'indicador només apareix sobre un únic color de fons llis alhora.

Resultats esperats

  • Les comprovacions núm. 1, núm. 2 i núm. 3 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 C40 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.