CKTIS / HTML
aria-invalid — informacja o niepoprawnej wartości
`aria-invalid` przekazuje stan błędu kontrolki, ale nie uruchamia walidacji i nie blokuje wysłania formularza.
Wersja: WAI-ARIA 1.2
Składnia
<input aria-invalid="true" aria-describedby="error">Wartości to false, true, grammar i spelling. Domyślnie nie sygnalizuje się błędu. Wybierz stan na podstawie faktycznej kontroli wartości, zwykle po interakcji lub próbie wysłania; nie oznaczaj pustego, jeszcze nieużytego formularza jako błędnego bez potrzeby.
Pokaż zrozumiałe wyjaśnienie i powiąż je z polem. Zmiana ARIA nie zastępuje ograniczeń HTML ani kontroli serwera. Po poprawieniu wartości usuń nieaktualny błąd oraz odpowiednio zaktualizuj stan.
Przykład wykrywa cyfry w nazwie wymagającej liter i pokazuje objaśnienie. Drzewo dostępności otrzymuje stan niepoprawny, ale checkValidity() nadal zwraca prawdę, bo nie ustawiono natywnego ograniczenia. To celowe pokazanie granicy, nie kompletna walidacja formularza.
Przykłady
<!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>Wynik
marked=true; nativeValid=true
Test sprawdza widoczny komunikat i semantyczny błąd, odróżniając je od natywnej poprawności pola.