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

Tècnica Scripts de client WCAG 2.2

SCR2Canviar una imatge decorativa tant amb el ratolí com amb el teclat

Nom oficial al W3C: Utilitzar gestors d'esdeveniments redundants de teclat i de ratolí

Versión en castellano

En poques paraules

De vegades un enllaç canvia una imatge decorativa en passar el ratolí per sobre. Aquest mateix canvi s'ha de produir quan l'enllaç rep el focus amb el teclat. Per fer-ho, els esdeveniments de ratolí s'acompanyen dels seus equivalents de teclat: focus i blur.

Per què és important

Moltes persones no utilitzen ratolí: persones amb mobilitat reduïda, persones cegues o qui navega amb el tabulador. Si un efecte només respon al ratolí, aquestes persones reben una experiència diferent o incompleta.

A més, el canvi visual en rebre el focus ajuda a veure on és el teclat en cada moment.

Com es fa

  1. Apliqueu l'efecte sobre un element que rebi el focus, com ara un enllaç <a href> o un botó.
  2. Al costat de mouseover, utilitzeu focus. Al costat de mouseout, utilitzeu blur. Tots dos han de cridar la mateixa funció.
  3. Si la imatge és decorativa, deixeu-la amb alt="" perquè el lector de pantalla la ignori.
  4. Utilitzeu imatges de la mateixa mida perquè la pàgina no es mogui.
  5. Avui, moltes vegades n'hi ha prou amb CSS: combineu :hover i :focus-visible en la mateixa regla.

Com comprovar-ho

  1. Passeu el ratolí per l'enllaç i observeu el canvi d'imatge.
  2. Torneu a carregar la pàgina i arribeu al mateix enllaç amb el tabulador.
  3. Comproveu que la imatge canvia igual en rebre el focus i torna al seu estat en sortir-ne.

Exemple

Un mateix canvi d'imatge per a ratolí i teclat.

const enlace = document.getElementById("enlace-agenda");
const icono = document.getElementById("icono-agenda");
function activar() { icono.src = "agenda-activa.png"; }
function desactivar() { icono.src = "agenda.png"; }
enlace.addEventListener("mouseover", activar);
enlace.addEventListener("focus", activar);
enlace.addEventListener("mouseout", desactivar);
enlace.addEventListener("blur", desactivar);
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica SCR2 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 amb suport d'scripts.

Descripció

L'objectiu d'aquesta tècnica és mostrar l'ús d'esdeveniments independents del dispositiu per canviar una imatge decorativa en resposta a un esdeveniment de ratolí o de focus. Utilitzeu els esdeveniments onmouseover i onmouseout per canviar una imatge decorativa quan el ratolí se situa sobre un element de la pàgina o se n'allunya. A més, utilitzeu els esdeveniments onfocus i onblur per canviar la imatge quan l'element rep i perd el focus.

L'exemple següent té una imatge decorativa davant d'un element d'ancoratge (enllaç). Quan l'usuari passa el ratolí sobre l'etiqueta d'ancoratge, la imatge decorativa situada davant de l'ancoratge canvia. Quan el ratolí s'allunya de l'ancoratge, la imatge torna a la seva versió original. El mateix efecte de canvi d'imatge es produeix quan l'usuari dona el focus del teclat a l'element d'ancoratge. En rebre el focus la imatge canvia i, en perdre'l, la imatge torna al seu estat original. Això s'aconsegueix associant a l'element d'ancoratge gestors dels esdeveniments onmouseover, onmouseout, onfocus i onblur. El gestor d'esdeveniments és una funció JavaScript anomenada updateImage(), que canvia l'atribut src de la imatge. updateImage() es crida en resposta als esdeveniments onmouseover, onmouseout, onfocus i onblur.

A cada imatge se li assigna un id únic. Aquest id únic es passa a updateImage() juntament amb un valor booleà que indica quina imatge s'ha d'utilitzar: updateImage(imgId, isOver);. El valor booleà true es passa quan el ratolí és sobre l'element d'ancoratge o aquest té el focus. Es passa el valor false quan el ratolí s'allunya de l'element d'ancoratge o aquest perd el focus. La funció updateImage() utilitza l'id de la imatge per carregar-la i després canvia l'atribut src en funció del valor booleà. Tingueu en compte que, com que la imatge té finalitats decoratives, el seu atribut alt és nul.

És recomanable utilitzar imatges de mida similar i especificar els atributs height i width a l'element d'imatge. Així s'evita qualsevol canvi en la maquetació de la pàgina quan s'actualitza la imatge. Aquest exemple utilitza imatges de mida idèntica.

Exemples

<!doctype html>
  <html lang="en">
  <head>
    <meta charset="utf-8">
    <title>Changing Image Source in a Device Independent Manner</title>
    <script>
       /* This function will change the image src of an image element.
        * param imgId - the id of the image object to change
        * param isOver - true when mouse is over or object has focus,
         false when mouse move out or focus is lost
       */
       function updateImage(imgId, isOver) {
       var theImage = document.getElementById(imgId);
       if (theImage != null) {
         if (isOver) {
           theImage.setAttribute("src","yellowplus.gif");
         }
         else {
           theImage.setAttribute("src","greyplus.gif");
         }
       }
     }
    </script>
  </head>
  <body>
    <p>Mouse over or tab to the links below and see the image change.</p>
    <a href="https://www.w3.org/WAI/"
       onmouseover="updateImage('wai', true);" onfocus="updateImage('wai', true);"
       onmouseout="updateImage('wai',false);" onblur="updateImage('wai',false);">
       <img alt="" id="wai" src="greyplus.gif">
       W3C Web Accessibility Initiative</a> &amp;
    <a href="https://www.w3.org/International/" onmouseover="updateImage('i18n', true);"
       onfocus="updateImage('i18n',true);" onmouseout="updateImage('i18n',false);"
       onblur="updateImage('i18n',false);">
       <img alt="" id="i18n" src="greyplus.gif">
       W3C Internationalization</a>
  </body>
</html>

Proves

Procediment

Carregar la pàgina web i provar els esdeveniments amb el ratolí i amb el teclat.

  1. Comprovar que la imatge «estàndard» es mostra com s'espera en carregar la pàgina web.
  2. Amb el ratolí:

    1. Moure el ratolí sobre l'element que conté els gestors d'esdeveniments (en aquest exemple és un element d'ancoratge). Comprovar que la imatge canvia a la imatge esperada.
    2. Allunyar el ratolí de l'element. Comprovar que la imatge torna a ser la imatge «estàndard».
  3. Amb el teclat:

    1. Utilitzar el teclat per situar el focus en l'element que conté els gestors d'esdeveniments. Comprovar que la imatge canvia a la imatge esperada.
    2. Utilitzar el teclat per treure el focus de l'element (generalment movent el focus a un altre element). Comprovar que la imatge torna a ser la imatge «estàndard».
  4. Verificar que la maquetació dels altres elements de la pàgina no es veu afectada quan canvia la imatge.

Resultats esperats

  • Tots els passos de les comprovacions anteriors són certs.

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 SCR2 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.