CKTIS / HTML
aria-modal — sémantika modálních dialogů
Atribut aria-modal informuje asistenční technologie, zda je zobrazený prvek modální, tedy zda je interakce omezena na jeho obsah. Sám o sobě neblokuje pozadí ani nespravuje fokus: deklarace musí odpovídat skutečnému chování rozhraní.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
aria-modal="true" | aria-modal="false"aria-modal je vlastnost WAI-ARIA používaná v HTML k určení, zda je zobrazený prvek modální. Hodnota true označuje modalitu; false je výchozí hodnota. Tato vlastnost přijímá textové hodnoty true a false a neřídí se syntaxí booleovských atributů HTML: název atributu nepište bez hodnoty. Je podporována u rolí dialog a alertdialog, nikoli obecně u libovolných prvků.
aria-modal="true" předává sémantiku asistenčním technologiím, které mohou omezit navigaci na obsah dialogu. Dialog neotevře, neblokuje kliknutí na pozadí a nepřesouvá ani nezadržuje fokus. Tuto hodnotu nastavte pouze tehdy, když rozhraní skutečně brání všem uživatelům v interakci s obsahem mimo dialog a pozadí je vizuálně ztmavené nebo zakryté.
Při otevření přesuňte fokus do dialogu a udržujte v něm posloupnost kláves Tab a Shift+Tab. Zajistěte uvnitř tlačítko pro zavření a podporu klávesy Escape; po zavření obvykle vraťte fokus na prvek, který dialog otevřel. Dialogu přiřaďte přístupný název, například pomocí aria-labelledby, které odkazuje na viditelný nadpis. Všechny ovládací prvky potřebné k používání dialogu musí být jeho potomky.
Příklad používá nativní dialog otevřený pomocí showModal(), místo aby modální chování ručně napodoboval. V tomto případě je výslovné aria-modal="true" nadbytečné, protože nativní modalita se asistenčním technologiím zpřístupňuje už sama; atribut je ponechán pro ukázku syntaxe. Samotné přidání atributu k běžnému kontejneru toto chování nezajistí. Ověřte zvlášť ovládání klávesnicí a sémantiku ve stromu přístupnosti.
Příklady
<!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>Výsledek
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.
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.