Tècnica Scripts de client WCAG 2.2
SCR39Fer llegible i tancable el contingut que apareix en passar el ratolí o en enfocar
Nom oficial al W3C: Fer que el contingut que apareix en passar el punter o en rebre el focus pugui rebre el punter, es pugui descartar i sigui persistent
En poques paraules
Les finestres emergents, els globus d'ajuda i les visualitzacions prèvies que apareixen en passar el ratolí o en arribar-hi amb el teclat han de complir tres coses. S'hi ha de poder moure el punter a sobre sense que desapareguin. No s'han de tancar soles. I s'han de poder tancar amb la tecla Esc sense moure el ratolí ni el focus.
Per què és important
Una persona amb baixa visió que utilitza un ampliador de pantalla (programa que amplia una part de la pantalla) només en veu un tros cada vegada. Per llegir un globus d'ajuda ha de moure el ratolí fins a ell. Si el globus desapareix en sortir del botó, no el pot llegir.
- Si el contingut es tanca sol al cap d'uns segons, qui llegeix a poc a poc es queda a mitges.
- Si tapa una altra part de la pàgina, per exemple un camp d'un formulari de cita prèvia, cal poder tancar-lo sense perdre la posició.
Com es fa
- Col·loqueu l'element que l'activa i el contingut emergent dins d'un mateix contenidor. Mostreu-lo mentre el punter sigui sobre qualsevol dels dos.
- Eviteu buits entre l'activador i el contingut emergent, perquè el punter no el tanqui en creuar-los.
- No utilitzeu temporitzadors per amagar-lo. Ha de continuar visible fins que la persona se'n vagi o el tanqui.
- Permeteu tancar-lo amb Esc sense moure el ratolí ni el focus (l'element que rep el que es tecleja).
- Mostreu-lo també quan l'activador rebi el focus amb el teclat, no només amb el ratolí.
Com comprovar-ho
- Passeu el ratolí per l'activador i porteu-lo a poc a poc fins al contingut emergent. No ha de desaparèixer.
- Deixeu el ratolí quiet una bona estona. El contingut ha de continuar visible.
- Amb el ratolí encara a sobre, premeu Esc. El contingut s'ha de tancar.
- Arribeu a l'activador amb el tabulador. El contingut ha d'aparèixer, quedar-se visible i tancar-se amb Esc sense perdre el focus.
Exemple
Script per a un globus d'ajuda que continua visible quan el punter és a sobre seu i es tanca amb Esc.
// El contenidor inclou el botó i el globus d'ajuda
const caja = document.querySelector('.ayuda');
const globo = caja.querySelector('[role="tooltip"]');
const mostrar = () => { globo.hidden = false; };
const ocultar = () => { globo.hidden = true; };
caja.addEventListener('mouseenter', mostrar);
caja.addEventListener('mouseleave', ocultar); // continua visible sobre el globus
caja.addEventListener('focusin', mostrar);
caja.addEventListener('focusout', ocultar);
document.addEventListener('keydown', (e) => {
if (e.key === 'Escape') ocultar(); // es tanca sense moure el ratolí ni el focus
});
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica SCR39 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
La tècnica és aplicable a qualsevol tecnologia que permeti mostrar contingut addicional en passar el punter per sobre.
Descripció
El contingut addicional que es mostra quan l'usuari mou el punter sobre un element activador o porta el focus del teclat a aquest activador (per exemple, una finestra emergent) ha de romandre visible per donar temps als usuaris a llegir-lo i interactuar-hi, i ha de permetre que l'usuari mogui el punter sobre el contingut addicional.
Les persones amb baixa visió que amplien la pantalla sovint només veuen una petita part de la pantalla alhora (la seva finestra gràfica). Això significa que el contingut addicional pot no ser completament visible a la finestra gràfica actual i que els usuaris potser necessiten moure el ratolí sobre el contingut addicional per llegir-lo. Per tant, els qui desenvolupen per al web s'han d'assegurar que el contingut addicional romangui visible quan el punter es desplaça des de l'activador fins al contingut addicional (normalment adjacent). El contingut addicional també s'ha de poder descartar sense moure el focus, de manera que els usuaris puguin llegir el contingut que queda tapat pel contingut addicional.
Exemples
Visualització prèvia del contingut dels enllaços
En passar el punter sobre un enllaç o en enfocar-lo, apareix una visualització prèvia del contingut de l'enllaç just a sobre o a sota. Els usuaris poden moure el punter sobre el contingut addicional (la finestra emergent) per poder llegir-lo completament. En prémer la tecla Esc es descarta (es tanca) el contingut addicional.
HTML de l'exemple 1
<p>This is the
<a class="a-and-tooltip" id="parent" href="index.html">trigger
<span id="popup" role="tooltip">And this additional text
gives additional context on the trigger term
</span>
</a>.
Text and popup are <strong>in one link (a)</strong> element.
</p>
CSS de l'exemple 1
[role="tooltip"] {
display: none;
padding: 0.5em;
background:white;
color: black;
border:solid black 2px;
width:10em;
}
.a-and-tooltip {
position: relative;
}
[role="tooltip"] {
position: absolute;
left:0;
top:1em;
}
JavaScript de l'exemple 1
// trigger and popup inside the same link
var parent = document.getElementById("parent");
parent.onmouseover = function() {
document.getElementById("popup").style.display = "block";
}
parent.onmouseout = function() {
document.getElementById("popup").style.display = "none";
}
parent.onfocus = function() {
document.getElementById("popup").style.display = "block";
}
parent.onblur = function() {
document.getElementById("popup").style.display = "none";
}
// hide when ESC is pressed
document.addEventListener("keydown", (e) => {
if ((e.keyCode || e.which) === 27)
document.getElementById("popup").style.display = "none";
});
Exemple funcional de contingut en passar el punter o en rebre el focus
Proves
Procediment
Per al contingut addicional que apareix en passar el punter, comprovar que:
- El punter es pot moure sobre el contingut addicional sense que aquest desaparegui.
- El contingut addicional roman visible i no es tanca automàticament passat un temps.
- El contingut es pot tancar sense apartar el punter de l'activador, ja sigui prement Esc, prement una altra drecera de teclat documentada o activant el mateix activador.
Per al contingut addicional que apareix en rebre el focus, comprovar que:
- El contingut addicional roman visible i no es tanca automàticament passat un temps.
- El contingut es pot tancar sense apartar el focus de l'activador, ja sigui prement Esc, prement una altra drecera de teclat documentada o activant el mateix activador.
Resultats esperats
Per al contingut que apareix en passar el punter:
- Les comprovacions núm. 1, núm. 2 i núm. 3 són certes.
Per al contingut que apareix en rebre el focus:
- Les comprovacions núm. 1 i núm. 2 són certes.
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.
Basat en la tècnica SCR39 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.