Teknika Bezero-scriptak WCAG 2.2
SCR34Testura egokitzen diren tamainak eta kokapenak JavaScript bidez kalkulatzea
Izen ofiziala W3Cn: Tamaina eta kokapena testuaren tamainarekin batera eskalatzeko moduan kalkulatzea
Laburbilduz
Script batzuek elementuak kokatzen dituzte pantailan, azpimenu bat edo laguntza-globo bat, adibidez. Teknika honek eskatzen du scriptak une horretako benetako tamaina eta kokapena neurtzea, pixeletan adierazitako zifra finkoak erabili beharrean. Horrela, pertsonak testua handitzen badu, elementuak hazi eta berriro kokatzen dira, elkar estali edo moztu gabe.
Zergatik da garrantzitsua
Ikusmen urria duten pertsona askok nabigatzailearen testua % 200era edo gehiagora handitzen dute. Script batek kutxa baten altuera 100 pixeletan finkatu badu, handitutako testua ez da sartzen. Moztuta geratzen da edo beste eduki baten gainean jartzen da.
Adibidez, «ertzetik 40 pixelera» kokatutako azpimenu bat hura irekitzen duen izenburuaren gainean gera daiteke. Pertsonak ezin du ez bata ez bestea irakurri.
Nola egiten da
- Saihestu scriptean pixeletako neurri finkoak idaztea altueretarako, zabaleretarako edo kokapenetarako.
- Lortu elementuaren benetako neurriak behar dituzunean:
offsetWidth,offsetHeightedogetBoundingClientRect(). - Elementu bat beste baten ondoan jartzeko, kalkulatu haren kokapena erreferentziako elementuaren kokapenetik abiatuta. Kontuan izan
offsetLeftetaoffsetTopberen edukiontziarekiko neurtzen direla, ez orriarekiko. - Kalkulatu berriro leihoaren edo testuaren tamaina aldatzen denean,
ResizeObservererabiliz, adibidez. - Ahal den guztietan, utzi CSSari lana egiten JavaScriptik gabe:
emedoremunitateak, flexbox edo grid.
Nola egiaztatu
- Aurkitu script batek kokatzen edo dimentsionatzen dituen elementuak: azpimenuak, laguntza-globoak, panelak.
- Handitu testuaren tamaina soilik % 200era, zooma erabili gabe. Firefoxen: Ikusi menua, Zooma, «Handitu testua soilik».
- Ireki elementu horiek eta egiaztatu testua osorik sartzen dela eta ezer ez dela moztuta edo estalita geratzen.
- Probatu, halaber, zooma % 400ean duela, 1280 pixeleko zabalerako leiho batean.
Adibidea
Laguntza-globo bat bere botoiaren azpian kokatzen da, botoiaren benetako kokapenaren arabera, eta tamaina aldatzen bada berriro kokatzen da.
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);
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko SCR34 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
Bezeroaren aldeko scriptak.
Deskribapena
Teknika honen helburua da elementuen tamaina eta kokapena kalkulatzea, testuaren tamaina eskalatzen denean behar bezala eskala daitezen.
JavaScripten lau propietatek laguntzen dute elementuen tamaina eta kokapena zehazten:
offsetHeight(elementuaren altuera pixeletan)offsetWidth(elementuaren zabalera pixeletan)offsetLeft(elementutik bere elementu gurasoaren (offsetParent) ezkerreko ertzera dagoen distantzia pixeletan)offsetTop(elementutik bere elementu gurasoaren (offsetParent) goiko ertzera dagoen distantzia pixeletan)
Altuera eta zabalera offsetHeight eta offsetWidth erabiliz kalkulatzea erraza da, baina objektu baten ezkerreko eta goiko kokapena balio absolutu gisa kalkulatzean, elementu gurasoa hartu behar da kontuan. Jarraian erakusten den calculatePosition funtzioak elementu baten nodo guraso guztiak korritzen ditu azken balioa lortzeko. Funtzioak bi parametro jasotzen ditu: objElement (dagokion elementuaren izena) eta desplazamendu-propietatea (offsetLeft edo offsetTop):
Adibideak
Elementuen tamaina eta kokapena kalkulatzea, testuaren tamaina eskalatzen denean behar bezala eskala daitezen
function calculatePosition(objElement, strOffset {
var iOffset = 0;
if (objElement.offsetParent) {
do {
iOffset += objElement[strOffset];
objElement = objElement.offsetParent;
} while (objElement);
}
return iOffset;
}
Hurrengo adibideak erakusten du nola erabil daitekeen aurreko funtzioa objektu bat erreferentziako objektu baten azpian lerrokatzeko, ezkerreko ertzetik distantzia berera:
// 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';
Probak
Prozedura
- Testuaren tamaina aldatzen denean edukiontzien tamaina doitzeko diseinatutako orri bat irekitzea.
- Testuaren tamaina % 200era arte handitzea nabigatzailearen testu-tamainaren doikuntzarekin (ez zoom-funtzioarekin).
- Testua aztertzea, edukiontziaren tamaina testuaren tamainari lekua egiteko doitzen dela ziurtatzeko.
- Ziurtatzea testuaren tamaina handitzearen ondorioz testurik ez dela «moztuta» geratzen edo desagertzen.
Espero diren emaitzak
- 3. eta 4. egiaztapenak egiazkoak dira.
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren SCR34 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.