CKTIS / HTML
aria-modal — semantika modalnih pogovornih oken
Atribut aria-modal tehnologijam za pomoč pove, ali je prikazani element modalni, kar pomeni, da je interakcija omejena na njegovo vsebino. Sam ne blokira ozadja in ne upravlja fokusa: navedba se mora ujemati z dejanskim delovanjem vmesnika.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
aria-modal="true" | aria-modal="false"aria-modal je lastnost WAI-ARIA, ki se v HTML uporablja za označevanje, ali je prikazani element modalni. Vrednost true označuje modalnost; false je privzeta vrednost. Lastnost sprejema besedilni vrednosti true in false ter ne uporablja sintakse logičnih atributov HTML: imena atributa ne zapišite brez vrednosti. Podprta je pri vlogah dialog in alertdialog, ne pa splošno pri poljubnih elementih.
aria-modal="true" tehnologijam za pomoč sporoča semantiko, zaradi katere lahko omejijo krmarjenje na vsebino pogovornega okna. Ne odpre pogovornega okna, ne blokira klikov v ozadju ter ne premakne ali zadrži fokusa. To vrednost nastavite le, kadar vmesnik vsem uporabnikom dejansko preprečuje interakcijo z vsebino zunaj pogovornega okna, ozadje pa je vizualno zatemnjeno ali prekrito.
Ob odprtju premaknite fokus v pogovorno okno in v njem zadržite zaporedje tipk Tab in Shift+Tab. V njem zagotovite gumb za zapiranje in podporo tipki Escape; ob zaprtju običajno vrnite fokus na element, ki je okno odprl. Pogovornemu oknu določite dostopno ime, na primer z aria-labelledby, ki kaže na vidni naslov. Vsi kontrolniki, potrebni za uporabo pogovornega okna, morajo biti njegovi potomci.
Primer uporablja izvorno pogovorno okno, odprto z showModal(), namesto da bi modalno vedenje ročno posnemal. V tem primeru je izrecni aria-modal="true" odvečen, saj je izvorna modalnost tehnologijam za pomoč že na voljo; ostane zaradi prikaza sintakse. Samo dodajanje atributa navadnemu vsebniku tega vedenja ne zagotovi. Ločeno preverite delovanje s tipkovnico in semantiko v drevesu dostopnosti.
Primeri
<!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.
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.