Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

aria-modal — semantyka modalności okna dialogowego

Atrybut aria-modal informuje technologie asystujące, czy wyświetlony element jest modalny, czyli ogranicza interakcję do swojego wnętrza. Nie blokuje samodzielnie tła ani nie zarządza fokusem: deklaracja musi odpowiadać rzeczywistemu zachowaniu interfejsu.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

aria-modal="true" | aria-modal="false"

aria-modal to właściwość WAI-ARIA stosowana w HTML, która określa, czy wyświetlony element jest modalny. Wartość true oznacza modalność, a false jest wartością domyślną. To właściwość o wartościach tekstowych true i false, a nie atrybut logiczny HTML: nie używaj samej nazwy atrybutu bez wartości. Obsługują ją role dialog i alertdialog; nie jest właściwością globalną dowolnego elementu.

aria-modal="true" przekazuje semantykę technologiom asystującym, które mogą ograniczyć nawigację do wnętrza okna. Nie otwiera okna, nie blokuje kliknięć w tle i nie przenosi ani nie zatrzymuje fokusu. Ustawiaj tę wartość tylko wtedy, gdy interfejs rzeczywiście uniemożliwia wszystkim użytkownikom interakcję z treścią poza oknem, a tło jest wizualnie przyciemnione lub zasłonięte.

Po otwarciu przenieś fokus do okna i utrzymuj sekwencję Tab oraz Shift+Tab w jego wnętrzu. Zapewnij dostępny wewnątrz przycisk zamknięcia i obsługę Escape; po zamknięciu zwykle przywróć fokus elementowi otwierającemu. Nadaj oknu dostępną nazwę, na przykład przez aria-labelledby wskazujące widoczny nagłówek. Wszystkie kontrolki potrzebne do obsługi okna muszą być jego potomkami.

Przykład wykorzystuje natywne okno otwierane przez showModal(), zamiast samodzielnie odtwarzać zachowanie modalne. W takim oknie jawne aria-modal="true" jest nadmiarowe, ponieważ natywna modalność jest już udostępniana technologiom asystującym; pozostawiono je, aby pokazać składnię. Samo dodanie atrybutu do zwykłego kontenera nie daje tego zachowania. Sprawdź osobno obsługę klawiatury oraz semantykę w drzewie dostępności.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>aria-modal example</title>
<style>
  dialog::backdrop { background: rgb(0 0 0 / 50%); }
</style>
<button id="open" type="button">Open dialog</button>
<dialog id="notice" aria-modal="true" aria-labelledby="heading">
  <h2 id="heading">Notice</h2>
  <p>This dialog blocks interaction with the page.</p>
  <button id="close" type="button" autofocus>Close</button>
</dialog>
<script>
  const opener = document.getElementById('open');
  const notice = document.getElementById('notice');
  const closer = document.getElementById('close');
  opener.addEventListener('click', () => notice.showModal());
  closer.addEventListener('click', () => notice.close());
  notice.addEventListener('close', () => opener.focus());
</script>
</html>

Wynik

Initially, only Open dialog is visible. Activating it opens Notice, dims the background, and focuses Close. Background controls cannot be activated while the dialog is open. Close or Escape dismisses the dialog and returns focus to Open dialog.

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła