Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / HTML

aria-modal — semantika modalnih dijaloških okvira

Atribut aria-modal obavještava pomoćne tehnologije je li prikazani element modalni, odnosno je li interakcija ograničena na njegov sadržaj. Sam po sebi ne blokira pozadinu niti upravlja fokusom: deklaracija mora odgovarati stvarnom ponašanju sučelja.

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

Sintaksa

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

aria-modal je svojstvo WAI-ARIA koje se u HTML-u koristi za označavanje je li prikazani element modalni. Vrijednost true označava modalnost; false je zadana vrijednost. Ovo svojstvo prihvaća tekstualne vrijednosti true i false i ne slijedi sintaksu logičkih HTML atributa: nemojte pisati naziv atributa bez vrijednosti. Podržano je uz uloge dialog i alertdialog, a ne općenito uz proizvoljne elemente.

aria-modal="true" prenosi semantiku pomoćnim tehnologijama, koje mogu ograničiti navigaciju na sadržaj dijaloškog okvira. Ne otvara dijalog, ne blokira klikove u pozadini niti premješta ili zadržava fokus. Postavite ovu vrijednost samo kada sučelje doista sprječava sve korisnike da stupaju u interakciju sa sadržajem izvan dijaloga, a pozadina je vizualno zatamnjena ili prekrivena.

Pri otvaranju premjestite fokus unutar dijaloškog okvira i zadržite u njemu slijed tipki Tab i Shift+Tab. Unutar okvira osigurajte gumb za zatvaranje i podršku za Escape; pri zatvaranju obično vratite fokus na element koji ga je otvorio. Dijaloškom okviru dodijelite pristupačan naziv, primjerice pomoću aria-labelledby koji upućuje na vidljivi naslov. Sve kontrole potrebne za korištenje dijaloškog okvira moraju biti njegovi potomci.

Primjer koristi izvorni dijaloški okvir otvoren pomoću showModal(), umjesto da ručno oponaša modalno ponašanje. U ovom je slučaju izričiti aria-modal="true" suvišan jer je izvorna modalnost već izložena pomoćnim tehnologijama; ostavljen je radi prikaza sintakse. Samo dodavanje atributa običnom spremniku ne omogućuje takvo ponašanje. Zasebno provjerite rad tipkovnicom i semantiku u stablu pristupačnosti.

Primjeri

<!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>

Rezultat

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.

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori