Tècnica Scripts de client WCAG 2.2 obsoleta
SCR37Crear quadres de diàleg propis que funcionin amb teclat (obsoleta)
Nom oficial al W3C: Crear quadres de diàleg personalitzats de manera independent del dispositiu
Tècnica obsoleta: el W3C ja no la recomana. |
En poques paraules
Tècnica obsoleta. Proposava crear finestres de diàleg pròpies amb un div, obrir-les des d'un botó o un enllaç i col·locar-les en el codi just després d'aquest control. Avui es recomana l'element dialog d'HTML o el patró de diàleg modal d'ARIA, que gestionen millor el focus i el teclat.
Per què és important
Molts webs mostren avisos, opcions o confirmacions en una finestra pròpia sobre la pàgina. Si es fa malament, qui utilitza teclat o lector de pantalla no hi arriba o no sap que s'ha obert. Un lector de pantalla és un programa que llegeix en veu alta el que hi ha a la pantalla.
Aquesta tècnica només resolia una part del problema. No impedia que el focus sortís del diàleg ni avisava que la resta de la pàgina quedava bloquejada. Per això ja no es recomana.
Com es fa
- Avui, utilitzeu l'element
<dialog>i obriu-lo ambshowModal(). El navegador mou el focus al diàleg, l'hi manté a dins i permet tancar-lo amb Esc. - Obriu-lo des d'un
<button>amb l'esdevenimentclick, que funciona amb ratolí i amb teclat. - Doneu un nom al diàleg, per exemple enllaçant-ne el títol amb
aria-labelledby. - En tancar-lo, el focus ha de tornar al botó que l'ha obert. Amb
showModal()el navegador sol fer-ho tot sol. - Si no podeu utilitzar
<dialog>, seguiu el patró de diàleg modal d'ARIA:role="dialog",aria-modal="true"i control del focus amb JavaScript. - El contingut del diàleg ha de ser tan accessible com la resta: camps amb etiqueta, botons amb nom i bon contrast.
Com comprovar-ho
- Localitzeu els botons o enllaços que obren finestres de diàleg.
- Arribeu a cadascun amb Tab i premeu Retorn. El diàleg s'ha d'obrir i el focus ha de passar al seu interior.
- Premeu Tab diverses vegades. El focus només s'ha de moure pels elements del diàleg.
- Premeu Esc o el botó de tancar. El focus ha de tornar al botó que l'ha obert.
- Amb un lector de pantalla, comproveu que s'anuncia com a diàleg i amb el seu títol.
Exemple
La manera actual de fer-ho: un diàleg natiu que s'obre des d'un botó.
<button type="button" id="abrir">Opcions d'impressió</button>
<dialog id="opciones" aria-labelledby="titulo-opciones">
<h2 id="titulo-opciones">Opcions d'impressió</h2>
<label><input type="checkbox"> Incloure-hi els annexos</label>
<form method="dialog"><button>Tanca</button></form>
</dialog>
<script>
document.getElementById('abrir').addEventListener('click', function () {
document.getElementById('opciones').showModal();
});
</script>
Veure el text complet del W3C (traducció al català)
Aquesta és una traducció no oficial al català de la tècnica SCR37 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
HTML i XHTML utilitzats amb scripts.
Descripció
Els qui dissenyen llocs web sovint volen crear quadres de diàleg que no utilitzin les finestres emergents que proporciona el navegador. Això se sol aconseguir tancant el contingut del quadre de diàleg en un div i col·locant aquest div per sobre del contingut de la pàgina mitjançant l'ordre z i el posicionament absolut de CSS.
Per ser accessibles, aquests quadres de diàleg han de seguir unes quantes regles senzilles.
- Llançar el script que obre el quadre de diàleg des de l'esdeveniment onclick d'un enllaç o d'un botó.
- Col·locar el
divdel quadre de diàleg en el model d'objectes del document (DOM) immediatament després de l'element que l'ha activat. L'element activador conservarà el focus i, en inserir el contingut del quadre de diàleg just després d'aquest element, el contingut del quadre de diàleg passarà a ser el següent en l'ordre de lectura del lector de pantalla i el següent en l'ordre de tabulació. El quadre de diàleg es pot continuar posicionant de manera absoluta perquè aparegui visualment en un altre lloc de la pàgina. Això es pot fer creant el quadre de diàleg en l'HTML i amagant-lo amb CSS, com en l'exemple següent, o inserint-lo immediatament després de l'element activador mitjançant un script. - Garantir que l'HTML de l'interior del div del quadre de diàleg compleix el mateix estàndard d'accessibilitat que la resta del contingut.
També és convenient, encara que no sempre necessari, que l'enllaç que obre el quadre de diàleg serveixi per obrir-lo i tancar-lo alternativament, i que el quadre de diàleg es tanqui quan el focus del teclat l'abandoni.
Exemples
Un botó d'opcions que obre un quadre de diàleg
L'HTML d'aquest exemple inclou un element activador, en aquest cas un botó, i un div que actua com a marc del quadre de diàleg.
L'element activador és un botó i el script es llança des de l'esdeveniment onclick. Això envia els esdeveniments adequats al sistema operatiu perquè les tecnologies de suport siguin conscients del canvi en el DOM.
En aquest exemple, els botons d'enviament (Submit) i de restabliment (Reset) de l'interior del quadre de diàleg es limiten a amagar el div.
...
<button onclick="TogglePopup(event,true)"
name="pop0001">Options</button>
<div class="popover" id="pop0001">
<h3>Edit Sort Information</h3>
<form action="default.htm" onsubmit="this.parentNode.style.display='none'; return false;" onreset="this.parentNode.style.display='none'; return false;">
<fieldset>
<legend>Sort Order</legend>
<input type="radio" name="order" id="order_alpha" /><label for="order_alpha">Alphabetical</label>
<input type="radio" name="order" id="order_default" checked="true" /><label for="order_default">Default</label>
</fieldset>
<div class="buttons">
<input type="submit" value="OK" />
<input type="reset" value="Cancel" />
</div>
</form>
</div>
...
El div, l'encapçalament i els elements form s'estilitzen amb CSS perquè semblin un quadre de diàleg.
...
a { color:blue; }
a.clickPopup img { border:none; width:0; }
div.popover { position:absolute; display:none; border:1px outset; background-color:beige; font-size:80%; background-color:#eeeeee; color:black; }
div.popover h3 { margin:0; padding:0.1em 0.5em; background-color:navy; color:white; }
#pop0001 { width:20em; }
#pop0001 form { margin:0; padding:0.5em; }
#pop0001 fieldset { margin-bottom:0.3em; padding-bottom:0.5em; }
#pop0001 input, #pop0001 label { vertical-align:middle; }
#pop0001 div.buttons { text-align:right; }
#pop0001 div.buttons input { width:6em; }
...
El script alterna la visualització del div emergent, mostrant-lo i amagant-lo.
...
function TogglePopup(evt,show) {
HarmonizeEvent(evt);
var src = evt.target;
if ("click" == evt.type) {
evt.returnValue = false;
}
var popID = src.getAttribute("name");
if (popID) {
var popup = document.getElementById(popID);
if (popup) {
if (true == show) {
popup.style.display = "block";
}
else if (false == show) {
popup.style.display = "none";
}
else {
popup.style.display = "block" == popup.style.display ? "none" : "block";
}
if ("block" == popup.style.display) {
//window.alert(document.documentElement.scrollHeight);
popup.style.top = ((document.documentElement.offsetHeight - popup.offsetHeight) / 2 ) + 'px';
popup.style.left = ((document.documentElement.offsetWidth - popup.offsetWidth) / 2) + 'px';
}
}
}
}
function SubmitForm(elem) {
elem.parentNode.style.display='none';
return false;
}
function ResetForm(elem) {
elem.parentNode.style.display='none';
return false;
}
...
Proves
Procediment
- Localitzar totes les àrees de la pàgina que obren quadres de diàleg que no siguin finestres emergents.
- Comprovar que els quadres de diàleg es poden obrir arribant a l'àrea amb la tecla de tabulació i prement Retorn.
- Comprovar que, un cop obert, el quadre de diàleg és el següent en l'ordre de tabulació.
- Comprovar que els quadres de diàleg s'obren des de l'esdeveniment de clic d'un botó o d'un enllaç.
- Amb una eina que permeti inspeccionar el DOM generat pel script, comprovar que el quadre de diàleg és el següent en el DOM.
Resultats esperats
- Les comprovacions núm. 2, núm. 3, núm. 4 i núm. 5 són certes.
Recursos
- ARIA Authoring Practices Guide - Dialog (Modal) (guia de pràctiques d'autoria d'ARIA: quadre de diàleg modal).
- HTML - the
dialogelement (especificació HTML: l'element dialog).
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 SCR37 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.