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