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

Tècnica Scripts de client WCAG 2.2

SCR26Inserir el contingut nou just després del control que l'obre

Nom oficial al W3C: Inserir contingut dinàmic al Document Object Model immediatament després de l'element que l'activa

Versión en castellano

En poques paraules

Quan un botó o un enllaç mostra contingut nou amb JavaScript, com ara un submenú o un tauler, aquest contingut ha d'anar al codi just darrere del control. Així, en prémer Tab o en continuar llegint amb el lector de pantalla, el que es troba a continuació és just el que acaba d'aparèixer.

Per què és important

Qui navega amb teclat avança amb la tecla Tab seguint l'ordre del codi HTML. El lector de pantalla (programa que llegeix en veu alta el que hi ha a la pantalla) també llegeix en aquest ordre.

Si l'script afegeix el submenú al final de la pàgina, la persona prem «Serveis» i no troba res a continuació. Hauria de recórrer tota la pàgina per arribar a les opcions noves. A la pantalla sembla ben col·locat, però al codi és lluny.

Com es fa

  1. Utilitzeu un <button> o un enllaç com a control que obre el contingut. Tots dos reben el focus i responen al teclat.
  2. Llanceu l'script des de l'esdeveniment click. Aquest esdeveniment funciona amb el ratolí i també amb el teclat.
  3. Inseriu el contingut nou al DOM (l'estructura de la pàgina que el navegador crea a partir de l'HTML) just després del control. Per exemple, amb control.after(panel).
  4. Deixeu el focus al control. La pulsació següent de Tab portarà al primer element del contingut nou.
  5. Si necessiteu una altra posició a la pantalla, moveu-lo amb CSS. No en canvieu el lloc al codi.
  6. Si el contingut arriba més tard des del servidor, aviseu-ne també el lector de pantalla, per exemple amb una regió aria-live.

Com comprovar-ho

  1. Obriu cada menú o tauler desplegable amb el teclat: arribeu al control amb Tab i premeu Retorn.
  2. Premeu Tab una vegada més. El focus ha d'anar al primer element del contingut que acaba d'aparèixer.
  3. Obriu les eines del navegador (F12), pestanya «Elements». Comproveu que el contingut nou és just després del control.
  4. Amb un lector de pantalla, continueu llegint després del control. Heu de sentir el contingut nou a continuació.

Exemple

Un botó «Serveis» crea el seu submenú i el col·loca just darrere seu al codi.

<button type="button" id="servicios" aria-expanded="false">Serveis</button>
<script>
var boton = document.getElementById('servicios');
boton.addEventListener('click', function () {
  var menu = document.createElement('ul');
  menu.innerHTML = '<li><a href="/padron">Padró</a></li>' +
                   '<li><a href="/tasas">Taxes i pagaments</a></li>';
  boton.after(menu); // just darrere del botó
  boton.setAttribute('aria-expanded', 'true');
}, { once: true });
</script>
Veure el text complet del W3C (traducció al català)

Aquesta és una traducció no oficial al català de la tècnica SCR26 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 scripts

Descripció

L'objectiu d'aquesta tècnica és col·locar els elements d'interfície d'usuari inserits al Document Object Model (DOM) de manera que l'ordre de tabulació i l'ordre de lectura del lector de pantalla quedin correctament establerts pel comportament predeterminat de l'agent d'usuari. Aquesta tècnica es pot utilitzar per a qualsevol element d'interfície d'usuari que s'amagui i es mostri, com ara menús i quadres de diàleg.

L'ordre de lectura en un lector de pantalla es basa en l'ordre dels elements HTML al Document Object Model, igual que l'ordre de tabulació predeterminat. Aquesta tècnica insereix el contingut nou al DOM immediatament després de l'element que s'ha activat per desencadenar l'script. L'element desencadenant ha de ser un enllaç o un botó, i l'script s'ha de cridar des del seu esdeveniment onclick. Aquests elements poden rebre el focus de manera nativa, i el seu esdeveniment onclick és independent del dispositiu. El focus roman a l'element activat, i el contingut nou, inserit a continuació, passa a ser el següent tant en l'ordre de tabulació com en l'ordre de lectura del lector de pantalla.

Tingueu en compte que aquesta tècnica funciona per a actualitzacions síncrones. Per a les actualitzacions asíncrones (de vegades anomenades AJAX), cal una tècnica addicional que informi la tecnologia de suport que s'ha inserit el contingut asíncron.

Exemples

Aquest exemple crea un menú quan es fa clic en un enllaç i l'insereix després de l'enllaç. L'esdeveniment onclick de l'enllaç s'utilitza per cridar l'script ShowHide, passant-li com a paràmetre un id per al nou menú.

<button aria-expanded="false" type="button" onclick="ShowHide('foo',this)">
  Toggle
</button>

L'script ShowHide crea un div que conté el nou menú i hi insereix un enllaç. L'última línia és el nucli de l'script. Localitza l'element pare de l'element que ha desencadenat l'script i li afegeix com a nou fill el div que ha creat. Això fa que el nou div quedi al DOM després del menú. Quan l'usuari prem la tecla de tabulació, el focus passarà al primer element del menú que el pugui rebre: l'enllaç que hem creat.

function ShowHide(id,src){
  var el = document.getElementById(id);
  if (!el){
    el = document.createElement("div");
    el.id = id;
    var link = document.createElement("a");
    link.href = "/laptops";
    link.appendChild(document.createTextNode("Laptops"));
    el.appendChild(link);
    src.parentElement.appendChild(el);
    src.setAttribute("aria-controls", id);
    src.setAttribute("aria-expanded", "true");
   }
   else if (el && src.getAttribute("aria-expanded") === "false"){
     el.style.display = 'block';
     src.setAttribute("aria-expanded", "true");
   }
   else{
     el.style.display = 'none';
     src.setAttribute("aria-expanded", "false");    
   }   
}

S'utilitza CSS per donar al div i a l'enllaç l'aspecte d'un menú.

Proves

Procediment

  1. Localitzar totes les zones de la pàgina que obren quadres de diàleg que no siguin finestres emergents.
  2. Comprovar que els quadres de diàleg s'activen des de l'esdeveniment click d'un botó o d'un enllaç.
  3. Amb una eina que permeti inspeccionar el DOM generat per l'script, comprovar que el quadre de diàleg és l'element següent al DOM.

Resultats esperats

  • Les comprovacions núm. 2 i núm. 3 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.

Sol·licitar una auditoria

Basat en la tècnica SCR26 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.