Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Interacciones accesibles en JavaScript

Una interacción accesible combina el uso con teclado, un foco predecible y un estado comprensible para las tecnologías de asistencia. JavaScript debe sincronizar la visibilidad con ARIA y comunicar las actualizaciones sin mover el foco innecesariamente.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

element.setAttribute('aria-expanded', String(expanded));
panel.hidden = !expanded;
trigger.focus();
status.textContent = message;

Una interacción accesible permite usar una interfaz sin ratón y comprender sus cambios con ayuda de tecnologías de asistencia. Empieza con botones nativos: aportan semántica y activación mediante el teclado. ARIA describe la interfaz, pero no añade comportamiento por sí sola. La especificación ECMAScript describe el lenguaje y lo separa de su entorno anfitrión; la fuente proporcionada no define DOM, HTML ni ARIA.

La gestión del estado de ARIA y del foco del teclado consiste en sincronizar el estado, la visibilidad y el foco. En el ejemplo, aria-expanded coincide con el valor inverso de panel.hidden, mientras que aria-controls identifica panel. En la prueba de apertura, el foco ya está en el botón Details y permanece allí; el panel no es un cuadro de diálogo modal. El manejador de Close details coloca el foco en Details antes de ocultar el panel. Cuando Details cierra el panel, setExpanded devuelve el foco a Details antes de ocultarlo si el foco sigue dentro del panel. La prueba de consola cubre ambas formas de cierre, incluida la activación de Details sin mover antes el foco a ese botón. No elimines el indicador de foco visible ni uses valores positivos de tabindex para corregir el orden de navegación.

Los anuncios de las regiones activas de ARIA comunican actualizaciones sin mover el foco. El ejemplo actualiza textContent en una región existente con role="status". Este rol proporciona de forma implícita el comportamiento de aria-live="polite"; el marcado no establece ningún atributo aria-live. El atributo aria-atomic="true" indica que todo el contenido de la región debe tratarse como el mensaje. La región existe antes de la actualización. No la uses en lugar de las etiquetas de los controles ni anuncies cada cambio menor. Las palabras exactas y el momento del anuncio dependen del navegador y de la tecnología de asistencia.

Guarda el ejemplo como archivo HTML y comprueba el uso del teclado, los valores de los atributos y los anuncios del lector de pantalla. El resultado esperado describe el estado del DOM y dónde está el foco, pero no garantiza lo que dirá el lector de pantalla. El ejemplo se ejecutó en un entorno aislado con Chromium y la salida de la consola coincidió exactamente con la esperada. Usa sintaxis de ECMAScript 2015 e interfaces del navegador; la compatibilidad con el entorno de destino debe comprobarse por separado. Node 24 en el repositorio no demuestra que esas interfaces sean compatibles.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Accessible disclosure</title>
</head>
<body>
  <button id="toggle" type="button" aria-expanded="false" aria-controls="panel">Details</button>
  <section id="panel" aria-label="Details" hidden>
    <p>Additional information.</p>
    <button id="close" type="button">Close details</button>
  </section>
  <p id="status" role="status" aria-atomic="true"></p>
  <script>
    const toggle = document.getElementById('toggle');
    const panel = document.getElementById('panel');
    const closeButton = document.getElementById('close');
    const statusMessage = document.getElementById('status');

    function setExpanded(expanded) {
      if (!expanded && panel.contains(document.activeElement)) {
        toggle.focus();
      }
      panel.hidden = !expanded;
      toggle.setAttribute('aria-expanded', String(expanded));
      statusMessage.textContent = expanded ? 'Details opened.' : 'Details closed.';
    }

    toggle.addEventListener('click', () => setExpanded(panel.hidden));
    closeButton.addEventListener('click', () => {
      toggle.focus();
      setExpanded(false);
    });

    function report(step) {
      console.log(`${step}: hidden=${panel.hidden}; aria-expanded=${toggle.getAttribute('aria-expanded')}; status=${JSON.stringify(statusMessage.textContent)}`);
    }

    report('Initial');
    toggle.focus();
    toggle.click();
    report('Open');
    console.log('Open kept focus on Details: ' + (document.activeElement === toggle));

    // Test closing when activation does not first focus the close button.
    toggle.blur();
    console.log('Focus inside panel before close: ' + panel.contains(document.activeElement));
    closeButton.click();
    report('Close');
    console.log('Focus returned to Details: ' + (document.activeElement === toggle));

    // Test closing with Details while focus remains inside the panel.
    toggle.click();
    closeButton.focus();
    console.log('Focus inside panel before closing with Details: ' + panel.contains(document.activeElement));
    toggle.click();
    report('Close with Details');
    console.log('Focus returned to Details: ' + (document.activeElement === toggle));
  </script>
</body>
</html>

Resultado

Initial: hidden=true; aria-expanded=false; status=""
Open: hidden=false; aria-expanded=true; status="Details opened."
Open kept focus on Details: true
Focus inside panel before close: false
Close: hidden=true; aria-expanded=false; status="Details closed."
Focus returned to Details: true
Focus inside panel before closing with Details: true
Close with Details: hidden=true; aria-expanded=false; status="Details closed."
Focus returned to Details: true

La prueba activa `Details` mediante código mientras el foco está en `Close details`. El foco debe volver a `Details` antes de que se oculte el panel.

Fuentes