Addaw, ir a inicio Donar

Técnica Scripts de cliente WCAG 2.2

SCR26Insertar contenido dinámico en el Document Object Model inmediatamente después del elemento que lo activa

En resumen

Esta técnica indica dónde insertar en el DOM el contenido que un script muestra u oculta (menús, diálogos, paneles): justo detrás del enlace o botón que lo activa. De este modo, el orden de tabulación y el orden de lectura del lector de pantalla quedan correctos sin más ajustes, y el usuario encuentra el contenido nuevo al pulsar Tab. Es útil en cualquier interfaz con contenido desplegable generado con JavaScript.

Aplicabilidad

HTML y scripts

Descripción

El objetivo de esta técnica es colocar los elementos de interfaz de usuario insertados en el Document Object Model (DOM) de tal forma que el orden de tabulación y el orden de lectura del lector de pantalla queden correctamente establecidos por el comportamiento predeterminado del agente de usuario. Esta técnica puede usarse para cualquier elemento de interfaz de usuario que se oculte y se muestre, como menús y cuadros de diálogo.

El orden de lectura en un lector de pantalla se basa en el orden de los elementos HTML en el Document Object Model, al igual que el orden de tabulación predeterminado. Esta técnica inserta el contenido nuevo en el DOM inmediatamente después del elemento que se ha activado para desencadenar el script. El elemento desencadenante debe ser un enlace o un botón, y el script debe llamarse desde su evento onclick. Estos elementos pueden recibir el foco de forma nativa, y su evento onclick es independiente del dispositivo. El foco permanece en el elemento activado, y el contenido nuevo, insertado a continuación, pasa a ser lo siguiente tanto en el orden de tabulación como en el orden de lectura del lector de pantalla.

Tenga en cuenta que esta técnica funciona para actualizaciones sincrónicas. Para las actualizaciones asíncronas (a veces llamadas AJAX), se necesita una técnica adicional que informe a la tecnología de asistencia de que se ha insertado el contenido asíncrono.

Ejemplos

Este ejemplo crea un menú cuando se hace clic en un enlace y lo inserta después del enlace. El evento onclick del enlace se usa para llamar al script ShowHide, pasándole como parámetro un id para el nuevo menú.

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

El script ShowHide crea un div que contiene el nuevo menú e inserta un enlace dentro de él. La última línea es el núcleo del script. Localiza el elemento padre del elemento que desencadenó el script y le añade como nuevo hijo el div que ha creado. Esto hace que el nuevo div quede en el DOM después del menú. Cuando el usuario pulsa la tecla de tabulación, el foco pasará al primer elemento del menú que pueda recibirlo: el enlace que hemos creado.

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");    
   }   
}

Se usa CSS para dar al div y al enlace el aspecto de un menú.

Pruebas

Procedimiento

  1. Localizar todas las zonas de la página que abren cuadros de diálogo que no sean ventanas emergentes.
  2. Comprobar que los cuadros de diálogo se activan desde el evento click de un botón o de un enlace.
  3. Con una herramienta que permita inspeccionar el DOM generado por el script, comprobar que el cuadro de diálogo es el siguiente elemento en el DOM.

Resultados esperados

  • Las comprobaciones n.º 2 y n.º 3 son verdaderas.

Cómo lo comprobamos en ADDAW

En las auditorías de accesibilidad de ADDAW revisamos cada criterio de conformidad siguiendo este catálogo de técnicas: comprobamos si la web aplica una técnica suficiente y documentamos cada fallo común con capturas y el código afectado, para que el equipo de desarrollo sepa exactamente qué corregir. Los informes siguen la metodología del Observatorio de Accesibilidad y la norma UNE-EN 301 549.

Solicitar una auditoría

Fuente y licencia

Traducción al español, no oficial, realizada por ADDAW a partir de la técnica SCR26 del documento «Techniques for WCAG 2.2» del W3C (versión del repositorio público del W3C a 22/10/2026). Copyright © W3C® (MIT, ERCIM, Keio, Beihang). Se publica conforme a la licencia de documentos del W3C. El texto normativo de referencia es el original en inglés; si detecta un error en la traducción, escríbanos.

Financiado por la unión europea Gobierno de españa red.es Plan de recuperación transformación y resilencia kit digital