Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

aria-modal — sémantika modálnych dialógov

Atribút aria-modal informuje asistenčné technológie, či je zobrazený prvok modálny, teda či je interakcia obmedzená na jeho obsah. Sám osebe neblokuje pozadie ani nespravuje fokus: deklarácia musí zodpovedať skutočnému správaniu rozhrania.

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

Syntax

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

aria-modal je vlastnosť WAI-ARIA používaná v HTML na určenie, či je zobrazený prvok modálny. Hodnota true označuje modalitu; false je predvolená hodnota. Táto vlastnosť prijíma textové hodnoty true a false a neriadi sa syntaxou booleovských atribútov HTML: názov atribútu nepíšte bez hodnoty. Podporuje sa pri rolách dialog a alertdialog, nie všeobecne pri ľubovoľných prvkoch.

aria-modal="true" odovzdáva sémantiku asistenčným technológiám, ktoré môžu obmedziť navigáciu na obsah dialógu. Dialóg neotvára, neblokuje kliknutia na pozadí a nepresúva ani nezadržiava fokus. Túto hodnotu nastavte iba vtedy, keď rozhranie skutočne bráni všetkým používateľom v interakcii s obsahom mimo dialógu a pozadie je vizuálne stmavené alebo zakryté.

Pri otvorení presuňte fokus do dialógu a udržujte v ňom postupnosť kláves Tab a Shift+Tab. Zabezpečte tlačidlo na zatvorenie vo vnútri a podporu klávesu Escape; po zatvorení zvyčajne vráťte fokus na prvok, ktorý dialóg otvoril. Dialógu priraďte prístupný názov, napríklad pomocou aria-labelledby, ktoré odkazuje na viditeľný nadpis. Všetky ovládacie prvky potrebné na používanie dialógu musia byť jeho potomkami.

Príklad používa natívny dialóg otvorený pomocou showModal(), namiesto ručného napodobňovania modálneho správania. V tomto prípade je výslovné aria-modal="true" nadbytočné, pretože natívna modalita sa asistenčným technológiám sprístupňuje už sama; atribút zostáva, aby ukázal syntax. Samotné pridanie atribútu k bežnému kontajneru toto správanie nezabezpečí. Samostatne skontrolujte ovládanie klávesnicou a sémantiku v strome prístupnosti.

Prí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ýsledok

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ýsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje