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

CKTIS / JavaScript

Estados ARIA de invalidez y ocultación y gestión del foco con tabindex

Comunica errores de validación, oculta adornos a las tecnologías de asistencia y mueve el foco sin añadir una parada extra a la navegación con Tab.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

HTML attributes: aria-invalid="true|false|grammar|spelling"; aria-hidden="true|false"; aria-errormessage="message-id"; hidden; tabindex="integer".
JavaScript DOM: control.setAttribute("aria-invalid", "true"); control.removeAttribute("aria-invalid"); message.hidden = false; message.tabIndex = -1; message.focus(); document.activeElement === message.

aria-invalid comunica el resultado de la validación a las tecnologías de asistencia; no valida el valor ni impide el envío. Establécelo en "true" cuando se detecte un error, pero espera a que se intente enviar el formulario antes de marcar un campo obligatorio vacío. Tras corregirlo, elimina el atributo o usa "false", su valor predeterminado. "grammar" y "spelling" indican errores de gramática y ortografía, respectivamente. Con "true", puedes usar aria-errormessage para vincular una instrucción de corrección visible mediante su ID.

aria-hidden="true" excluye un elemento y sus descendientes del árbol de accesibilidad sin ocultarlos visualmente ni impedir que reciban el foco. Úsalo en contenido decorativo o redundante, nunca en un elemento que pueda recibir el foco ni en sus antecesores. aria-hidden="false" no revierte la ocultación de un antecesor. Para ocultar un mensaje normal a todo el mundo, usa message.hidden = true; usa false para mostrarlo.

La propiedad DOM tabIndex corresponde al atributo HTML tabindex. Sin el atributo, los controles nativos conservan su comportamiento de foco predeterminado. 0 incorpora el elemento a la secuencia normal, generalmente en el orden del documento. -1 permite usar focus(), pero normalmente excluye el elemento de la navegación con Tab. Evita los valores positivos: dentro del mismo ámbito de navegación del foco, sitúan los elementos antes de las paradas habituales, en orden numérico ascendente. La configuración del navegador y del sistema puede afectar a la secuencia.

Muestra el destino antes de llamar a focus(). Si vas a ocultar el elemento que tiene el foco, muévelo primero a un lugar útil. En el ejemplo, noValidate omite la validación automática al enviar, pero validity.valueMissing sigue detectando el campo obligatorio vacío. Son funciones de la plataforma web, no de ECMAScript. document.activeElement comprueba el foco del DOM, no lo que anunciará un lector de pantalla.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Form validation and focus</title>
</head>
<body>
<script>
(() => {
  const form = document.createElement('form');
  form.noValidate = true;

  const input = document.createElement('input');
  input.required = true;
  const label = document.createElement('label');
  label.append('Name ', input);

  const error = document.createElement('p');
  error.id = 'ck-focus-name-error';
  error.textContent = 'Enter your name.';
  error.hidden = true;
  error.tabIndex = -1;

  const submit = document.createElement('button');
  submit.type = 'submit';
  const decoration = document.createElement('span');
  decoration.textContent = ' →';
  decoration.setAttribute('aria-hidden', 'true');
  submit.append('Submit', decoration);

  function clearError() {
    input.removeAttribute('aria-invalid');
    input.removeAttribute('aria-errormessage');
    error.hidden = true;
  }

  input.addEventListener('input', () => {
    if (!input.validity.valueMissing) clearError();
  });

  form.addEventListener('submit', (event) => {
    event.preventDefault();
    if (input.validity.valueMissing) {
      error.hidden = false;
      input.setAttribute('aria-invalid', 'true');
      input.setAttribute('aria-errormessage', error.id);
      error.focus();
    } else {
      clearError();
    }
    console.log(`aria-invalid=${input.getAttribute('aria-invalid')}; hidden=${error.hidden}; errorFocused=${document.activeElement === error}`);
  });

  form.append(error, label, ' ', submit);
  document.body.append(form);
})();
</script>
</body>
</html>

Resultado

aria-invalid=true; hidden=false; errorFocused=true
aria-invalid=null; hidden=true; errorFocused=false

Guarda el ejemplo como `example.html` y ábrelo en un navegador. Abre la consola de desarrollo para ver las líneas registradas. Haz clic en `Submit` con `Name` vacío: el error aparece y recibe el foco. En la página, pulsa Tab, escribe `Ada` en `Name` y vuelve a hacer clic en `Submit`. El error desaparece en cuanto introduces un valor y el formulario no envía datos. La flecha sigue visible y no contribuye al nombre accesible del botón.

Lecciones relacionadas

  • JavaScript · Lección 23 · Intermedio · Versión: 3

Fuentes