CKTIS / JavaScript
Stati ARIA di invalidità e visibilità e gestione del focus con tabindex
Segnala gli errori di validazione, nascondi i contenuti decorativi alle tecnologie assistive e sposta il focus senza aggiungere una tappa alla navigazione con Tab.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
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 alle tecnologie assistive l’esito della validazione: non verifica il valore e non blocca l’invio. Impostalo su "true" quando rilevi un errore, ma per un campo obbligatorio vuoto aspetta un tentativo di invio. Dopo la correzione, rimuovi l’attributo o impostalo su "false", il valore predefinito. "grammar" e "spelling" segnalano rispettivamente errori grammaticali e ortografici. Con "true", puoi usare aria-errormessage per associare, tramite ID, un messaggio visibile che spieghi come correggere l’errore.
aria-hidden="true" esclude un elemento e i suoi discendenti dall’albero di accessibilità, senza nasconderli visivamente né impedire che ricevano il focus. Usalo per contenuti decorativi o ridondanti, mai su elementi che possono ricevere il focus né sui loro antenati. aria-hidden="false" non annulla l’effetto di un antenato nascosto. Per nascondere a tutti un normale messaggio, imposta message.hidden = true; usa false per mostrarlo.
La proprietà DOM tabIndex corrisponde all’attributo HTML tabindex. Se l’attributo manca, i controlli nativi mantengono il comportamento predefinito del focus. 0 inserisce l’elemento nella sequenza normale, di solito secondo l’ordine del documento. -1 consente di usare focus(), ma normalmente esclude l’elemento dalla navigazione con Tab. Evita valori positivi: nello stesso ambito di navigazione del focus, collocano gli elementi prima delle tappe ordinarie, in ordine numerico crescente. Le impostazioni del browser e del sistema possono influire sulla sequenza.
Mostra la destinazione prima di chiamare focus(). Se stai per nascondere un elemento che ha il focus, spostalo prima in un punto utile. Nell’esempio, noValidate salta la validazione automatica all’invio, ma validity.valueMissing rileva comunque il campo obbligatorio vuoto. Sono funzionalità della piattaforma web, non di ECMAScript. document.activeElement verifica il focus nel DOM, non ciò che annuncerà un lettore di schermo.
Esempi
<!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>Risultato
aria-invalid=true; hidden=false; errorFocused=true aria-invalid=null; hidden=true; errorFocused=false
Salva l’esempio come `example.html` e aprilo in un browser. Apri la console per sviluppatori per vedere le righe di output. Fai clic su `Submit` lasciando `Name` vuoto: il messaggio di errore appare e riceve il focus. Nella pagina premi Tab, digita `Ada` in `Name` e fai di nuovo clic su `Submit`. L’errore scompare appena inserisci un valore e il modulo non invia dati. La freccia rimane visibile e non contribuisce al nome accessibile del pulsante.
Lezioni correlate
- JavaScript · Lezione 23 · Intermedio · Versione: 3