Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła