CKTIS / HTML
aria-invalid — einen ungültigen Wert melden
`aria-invalid` vermittelt den Fehlerzustand eines Bedienelements, führt aber keine Validierung aus und verhindert kein Absenden.
Version: WAI-ARIA 1.2
Syntax
<input aria-invalid="true" aria-describedby="error">Werte sind false, true, grammar und spelling. Standardmäßig wird kein Fehler gemeldet. Bestimme den Zustand durch eine tatsächliche Prüfung, normalerweise nach einer Interaktion oder einem Absendeversuch; markiere ein unbenutztes leeres Formular nicht unnötig als ungültig.
Zeige eine hilfreiche Erklärung und verknüpfe sie mit dem Feld. Eine ARIA-Änderung ersetzt weder HTML-Bedingungen noch Serverprüfungen. Entferne nach Korrektur des Werts den überholten Fehler und aktualisiere den Zustand entsprechend.
Das Beispiel erkennt Ziffern in einem Namen, der Buchstaben verlangt, und zeigt eine Erklärung. Der Barrierefreiheitsbaum erhält den ungültigen Zustand; checkValidity() liefert trotzdem wahr, weil keine native Bedingung gesetzt wurde. Dies zeigt bewusst die Grenze und ist keine vollständige Formularvalidierung.
Beispiele
<!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>Ergebnis
marked=true; nativeValid=true
Der Test prüft sichtbare Erklärung und semantischen Fehler und unterscheidet sie von der nativen Feldgültigkeit.