Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

aria-invalid — segnalare un valore non valido

`aria-invalid` comunica lo stato di errore di un controllo, ma non esegue validazione né impedisce l’invio del modulo.

Versione: WAI-ARIA 1.2

Sintassi

<input aria-invalid="true" aria-describedby="error">

I valori sono false, true, grammar e spelling. Normalmente non viene segnalato alcun errore. Scegli lo stato in base a una verifica reale, di solito dopo un’interazione o un tentativo di invio; non indicare inutilmente come invalido un modulo vuoto ancora intatto.

Mostra una spiegazione utile e associala al campo. Cambiare ARIA non sostituisce i vincoli HTML né i controlli del server. Quando il valore viene corretto, rimuovi l’errore superato e aggiorna lo stato di conseguenza.

L’esempio rileva cifre in un nome che richiede lettere e mostra una spiegazione. L’albero di accessibilità riceve lo stato invalido, ma checkValidity() restituisce ancora vero, perché non è stato definito alcun vincolo nativo. È una dimostrazione intenzionale del limite, non una validazione completa del modulo.

Esempi

<!doctype html><meta charset="utf-8">
<label for="name">Project name</label><input id="name" value="123" aria-describedby="error">
<p id="error" hidden>Use letters only.</p><output id="result"></output>
<script>
const input = document.querySelector('#name');
const invalid = !/^[A-Za-z]+$/.test(input.value);
input.setAttribute('aria-invalid', String(invalid));
document.querySelector('#error').hidden = !invalid;
document.querySelector('#result').textContent = 'marked=' + invalid + '; nativeValid=' + input.checkValidity();
</script>

Risultato

marked=true; nativeValid=true

Il test verifica spiegazione visibile ed errore semantico, distinguendoli dalla validità nativa del campo.

Fonti