Tècnica Scripts de client WCAG 2.2
SCR34Calcular amb JavaScript mides i posicions que s'adaptin al text
Nom oficial al W3C: Calcular la mida i la posició de manera que s'escalin amb la mida del text
En poques paraules
Alguns scripts col·loquen elements a la pantalla, com ara un submenú o un globus d'ajuda. Aquesta tècnica demana que l'script mesuri la mida i la posició reals en aquell moment, en lloc d'utilitzar xifres fixes en píxels. Així, si la persona amplia el text, els elements creixen i es recol·loquen sense tapar-se ni tallar-se.
Per què és important
Moltes persones amb baixa visió amplien el text del navegador al 200 % o més. Si un script ha fixat l'alçària d'una caixa en 100 píxels, el text ampliat no hi cap. Queda tallat o se superposa a un altre contingut.
Per exemple, un submenú col·locat «a 40 píxels de la vora» pot acabar a sobre del títol que l'obre. La persona no pot llegir ni una cosa ni l'altra.
Com es fa
- Eviteu escriure a l'script mesures fixes en píxels per a alçàries, amplades o posicions.
- Obteniu les mesures reals de l'element quan les necessiteu:
offsetWidth,offsetHeightogetBoundingClientRect(). - Per col·locar un element al costat d'un altre, calculeu-ne la posició a partir de la de l'element de referència. Tingueu en compte que
offsetLeftioffsetTopes mesuren respecte al seu contenidor, no a la pàgina. - Torneu a calcular quan canviï la mida de la finestra o del text, per exemple amb
ResizeObserver. - Sempre que es pugui, deixeu que el CSS faci la feina sense JavaScript: unitats
emorem, flexbox o grid.
Com comprovar-ho
- Localitzeu els elements que col·loca o dimensiona un script: submenús, globus d'ajuda, taulers.
- Augmenteu només la mida del text al 200 %, sense utilitzar el zoom. A Firefox: menú Visualitza, Escala, «Amplia només el text».
- Obriu aquests elements i comproveu que el text hi cap sencer i que res no queda tallat ni tapat.
- Proveu-ho també amb el zoom al 400 % en una finestra de 1280 píxels d'amplada.
Exemple
Un globus d'ajuda es col·loca sota el seu botó segons la posició real d'aquest i es recol·loca si canvia la mida.
var boton = document.getElementById('ayuda');
var globo = document.getElementById('globo');
function colocar() {
var caja = boton.getBoundingClientRect();
globo.style.top = (caja.bottom + window.scrollY) + 'px';
globo.style.left = (caja.left + window.scrollX) + 'px';
}
colocar();
new ResizeObserver(colocar).observe(document.body);
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica SCR34 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
Scripts del costat del client.
Descripció
L'objectiu d'aquesta tècnica és calcular la mida i la posició dels elements de manera que s'escalin adequadament quan s'escala la mida del text.
En JavaScript hi ha quatre propietats que ajuden a determinar la mida i la posició dels elements:
offsetHeight(l'alçària de l'element en píxels)offsetWidth(l'amplada de l'element en píxels)offsetLeft(la distància de l'element a la vora esquerra del seu element pare (offsetParent) en píxels)offsetTop(la distància de l'element a la vora superior del seu element pare (offsetParent) en píxels)
Calcular l'alçària i l'amplada amb offsetHeight i offsetWidth és senzill, però en calcular la posició esquerra i superior d'un objecte com a valors absoluts cal tenir en compte l'element pare. La funció calculatePosition que es mostra a continuació recorre tots els nodes pare d'un element per obtenir el valor final. La funció rep dos paràmetres: objElement (el nom de l'element en qüestió) i la propietat de desplaçament (offsetLeft o offsetTop):
Exemples
Calcular la mida i la posició dels elements de manera que s'escalin adequadament quan s'escala la mida del text
function calculatePosition(objElement, strOffset {
var iOffset = 0;
if (objElement.offsetParent) {
do {
iOffset += objElement[strOffset];
objElement = objElement.offsetParent;
} while (objElement);
}
return iOffset;
}
L'exemple següent il·lustra l'ús de la funció anterior per alinear un objecte sota un objecte de referència, a la mateixa distància de la vora esquerra:
// Get a reference object
var objReference = document.getElementById('refobject');
// Get the object to be aligned
var objAlign = document.getElementById('lineup');
objAlign.style.position = 'absolute';
objAlign.style.left = calculatePosition(objReference, 'offsetLeft') + 'px';
objAlign.style.top = calculatePosition(objReference, 'offsetTop')
+ objReference.offsetHeight + 'px';
Proves
Procediment
- Obrir una pàgina dissenyada per ajustar la mida dels contenidors quan canvia la mida del text.
- Augmentar la mida del text fins al 200 % amb l'ajust de mida del text del navegador (no amb la funció de zoom).
- Examinar el text per assegurar-se que la mida del contenidor s'ajusta per donar cabuda a la mida del text.
- Assegurar-se que cap text no queda «retallat» o ha desaparegut com a conseqüència de l'augment de la mida del text.
Resultats esperats
- Les comprovacions núm. 3 i núm. 4 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 SCR34 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.