CKTIS / JavaScript
Stany ARIA nieprawidłowości i ukrycia oraz zarządzanie fokusem przez tabindex
Dowiedz się, jak oznaczać błędy walidacji, ukrywać elementy dekoracyjne przed technologiami asystującymi i przenosić fokus bez dodawania przystanku w nawigacji klawiszem Tab.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
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 przekazuje wynik walidacji technologiom asystującym; sam nie sprawdza wartości ani nie blokuje wysłania formularza. Ustaw "true" po wykryciu błędu, a w przypadku pustego wymaganego pola poczekaj na próbę wysłania. Po poprawieniu usuń atrybut lub ustaw "false", czyli wartość domyślną. Wartości "grammar" i "spelling" sygnalizują odpowiednio błędy gramatyczne i ortograficzne. Przy "true" możesz powiązać widoczną instrukcję poprawy z polem przez aria-errormessage, podając identyfikator komunikatu.
aria-hidden="true" usuwa element wraz z potomkami z drzewa dostępności, ale nie ukrywa go wizualnie ani nie wyłącza fokusu. Używaj go do treści dekoracyjnych lub powtórzonych, nigdy na elemencie fokusowalnym ani na jego przodku. aria-hidden="false" nie znosi ukrycia ustawionego na przodku. Aby ukryć zwykły komunikat przed wszystkimi użytkownikami, ustaw message.hidden = true; użyj false, aby go pokazać.
Właściwość DOM tabIndex odpowiada atrybutowi HTML tabindex. Bez atrybutu natywne kontrolki zachowują domyślne zachowanie fokusu. 0 włącza element do zwykłej kolejności nawigacji, zazwyczaj zgodnej z kolejnością dokumentu. -1 pozwala użyć focus(), ale zwykle pomija element przy nawigacji klawiszem Tab. Unikaj wartości dodatnich: w tym samym zakresie nawigacji umieszczają elementy przed zwykłymi przystankami, rosnąco według wartości. Na kolejność mogą wpływać ustawienia przeglądarki i systemu.
Pokaż cel, zanim wywołasz focus(). Jeśli chowasz element mający fokus, najpierw przenieś fokus w sensowne miejsce. W przykładzie noValidate wyłącza automatyczną walidację przy wysyłaniu, ale validity.valueMissing nadal wykrywa puste wymagane pole. Są to mechanizmy platformy webowej, nie ECMAScriptu. document.activeElement pozwala sprawdzić fokus w DOM, lecz nie gwarantuje, co ogłosi czytnik ekranu.
Przykłady
<!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>Wynik
aria-invalid=true; hidden=false; errorFocused=true aria-invalid=null; hidden=true; errorFocused=false
Zapisz przykład jako `example.html` i otwórz plik w przeglądarce. W konsoli deweloperskiej zobaczysz zalogowane wiersze. Kliknij `Submit`, pozostawiając `Name` puste: pojawi się komunikat i przejmie fokus. Na stronie naciśnij Tab, wpisz `Ada` w polu `Name` i ponownie kliknij `Submit`. Komunikat znika już po wpisaniu wartości, a formularz nie wysyła danych. Strzałka pozostaje widoczna i nie wchodzi do dostępnej nazwy przycisku.
Powiązane lekcje
- JavaScript · Lekcja 23 · Średniozaawansowany · Wersja: 3