Web a vývoj

Jak vytvořit přístupné modální dialogy s HTML, CSS a JavaScriptem

How to Create Accessible Modal Dialogs with HTML, CSS, and JavaScript

Vytvořte přístupné modální dialogy pomocí nativního HTML dialogového prvku. Naučte se, jak otevírat a zavírat vyskakovací okna, spravovat klávesovou navigaci, stylizovat pozadí a vytvářet potvrzovací dialogy bez knihovny JavaScriptu.

Jak vytvořit přístupné modální dialogy pomocí HTML, CSS a JavaScriptu

Návštěvník klikne na tlačítko na vašem webu. Objeví se vyskakovací okno s formulářem, potvrzovací zprávou nebo dalšími informacemi.

Vytvoření vizuálního vyskakovacího okna je snadné. Aby fungovalo správně s klávesnicí, čtečkou obrazovky a mobilním prohlížečem, je jiná věc.

Mnoho vlastních implementací modálních oken spoléhá na velké množství JavaScriptu pro správu fokusu, blokování interakce se stránkou a zpracování klávesy Escape.

Moderní HTML nabízí jednodušší přístup: nativní <dialog> element.

Ten poskytuje většinu chování, která se od modálního dialogu očekává, přímo v prohlížeči. Můžete vytvořit funkční vyskakovací okno s malým množstvím HTML, CSS a JavaScriptu, aniž byste museli instalovat framework nebo plugin.

V tomto tutoriálu vytvoříme znovupoužitelný modální dialog, nastylujeme ho, přidáme potvrzovací dialog a prozkoumáme detaily přístupnosti, které mají význam na reálných webech.

1. Co dělá modální dialog odlišným od běžného vyskakovacího okna?

Modální dialog dočasně vyžaduje, aby návštěvník interagoval s konkrétní částí rozhraní před návratem na hlavní stránku.

Typické příklady zahrnují:

  • Potvrzení smazání položky.
  • Zobrazení kontaktního formuláře.
  • Žádost o potvrzení před opuštěním stránky.
  • Zobrazení dalších informací o produktu.
  • Úprava nastavení aplikace.

Správně implementovaný modální dialog by měl ujasnit svůj účel, nabídnout zřejmý způsob zavření a vhodně spravovat klávesový fokus.

Nativní <dialog> element podporuje jak modální, tak nemodální chování.

Metoda Chování
showModal() Otevře modální dialog a zbytek dokumentu bude inertní
show() Otevře nemodální dialog
close() Zavře dialog
method="dialog" Umožní tlačítko formuláře zavřít dialog

Modální chování zahrnuje správu fokusu a klávesovou interakci poskytovanou prohlížečem.

2. Vytvořte svůj první HTML modální dialog

Začněme jednoduchým příkladem: tlačítko, které otevírá dialog obsahující nadpis, nějaký text a tlačítko pro zavření.

<button type="button" id="openDialog">
    View delivery information
</button>

<dialog id="deliveryDialog"
        aria-labelledby="deliveryTitle">

    <h2 id="deliveryTitle">
        Delivery information
    </h2>

    <p>
        Orders are prepared within two business days.
        You will receive a tracking link by email.
    </p>

    <form method="dialog">
        <button type="submit" autofocus>
            Close
        </button>
    </form>

</dialog>

<script>
const openButton = document.getElementById('openDialog');
const dialog = document.getElementById('deliveryDialog');

openButton.addEventListener('click', () => {
    dialog.showModal();
});
</script>

To stačí pro vytvoření fungujícího modálního dialogu.

Když návštěvník klikne na tlačítko, showModal() otevře dialog nad obsahem stránky.

Prohlížeč automaticky zpracuje několik důležitých chování:

  • Dialog vstoupí do vrchní vrstvy, nad běžný obsah stránky.
  • Zbytek dokumentu se stane inertním.
  • Klávesový fokus se posune do dialogu.
  • Stisknutí Escape normálně dialog zavře.
  • Fokus se normálně vrátí na otevírací tlačítko při zavření dialogu.

Tlačítko pro zavření používá method="dialog", takže nevyžaduje JavaScript obslužnou rutinu události.

3. Nastylujte dialog pomocí CSS

Výchozí dialog funguje, ale jeho vzhled je základní.

Můžeme mu dát zaoblené rohy, pohodlné odsazení, responzivní šířku a pozadí.

dialog {
    width: min(90vw, 520px);
    max-height: 85vh;
    box-sizing: border-box;
    padding: 2rem;
    border: 0;
    border-radius: 14px;
    background: #fff;
    color: #20242b;
    box-shadow: 0 20px 70px rgba(0, 0, 0, .2);
    overflow: auto;
}

dialog::backdrop {
    background: rgba(15, 23, 42, .65);
    backdrop-filter: blur(3px);
}

dialog h2 {
    margin-top: 0;
    font-size: 1.5rem;
}

dialog p {
    line-height: 1.6;
}

dialog button {
    padding: .75rem 1.25rem;
    border: 0;
    border-radius: 8px;
    background: #2458d3;
    color: #fff;
    font: inherit;
    cursor: pointer;
}

dialog button:focus-visible {
    outline: 3px solid #f59e0b;
    outline-offset: 3px;
}

::backdrop pseudo-element nastyluje vrstvu za modálním dialogem.

Zobrazí se pouze když je dialog zobrazen modálně, například přes showModal().

Dialog otevřený přes show() nedostane automaticky stejné modální chování pozadí.

Proč používat vrchní vrstvu?

Tradiční vlastní vyskakovací okna často spoléhají na stále větší z-index hodnoty.

Modální dialog otevřený přes showModal() vstupuje do vrchní vrstvy prohlížeče, což vyhne mnoha problémům s kontextem zanorování (stacking context).

To je obzvláště užitečné na webech obsahujících lepkavé hlavičky, plovoucí widgety a složité page buildery.

4. Pochopte klávesovou přístupnost

Modální dialog musí fungovat bez myši.

Představte si návštěvníka, který prochází váš web klávesou Tab. Když se modální dialog otevře, měl by moci interagovat s jeho ovládacími prvky bez toho, aby se omylem dostal na stránku za ním.

Nativní modální dialog pomáhá s tímto chováním.

W3C popisuje HTML dialog element jako techniku pro vytváření přístupných modálních dialogů, včetně uvěznění fokusu a návratu fokusu při zavření dialogu.

Dejte dialogu přístupný název

Použijte viditelný nadpis a odkazujte na něj přes aria-labelledby:

<dialog aria-labelledby="settingsTitle">
    <h2 id="settingsTitle">Account settings</h2>
    ...
</dialog>

Toto poskytuje pomůckám technologiím smysluplný název pro dialog.

Pečlivě zvolte počáteční fokus

autofocus atribut může identifikovat ovládací prvek, který by měl získat fokus při otevření modálního dialogu.

Pro informační dialog může být vhodné zaměřit tlačítko pro zavření.

Illustration of the article's main concept

Pro formulář může dávat smysl zaměřit první vstup.

Pro destruktivní potvrzení je často vhodné zaměřit bezpečnější akci, jako je Zrušit.

Vyhněte se umístění tabindex přímo na <dialog> element; HTML specifikace zakazuje tento atribut na samotném elementu.

Vždy poskytněte viditelné tlačítko pro zavření

I když Escape normálně zavírá modální dialog, viditelný ovládací prvek pro zavření zůstává nezbytný.

Mobilní návštěvníci nemusí mít fyzickou klávesnici, a někteří uživatelé nemusí vědět, že Escape může vyskakovací okno zavřít.

5. Vytvořte potvrzovací dialog se dvěma tlačítky

Nyní vytvoříme užitečnější příklad: potvrzení smazání uložené položky.

Návštěvník by měl moci zvolit Zrušit nebo Smazat.

HTML poskytuje pohodlný mechanismus přes method="dialog" a vlastnost dialogu returnValue.

<button type="button" id="deleteItem">
    Delete item
</button>

<dialog id="confirmDialog"
        aria-labelledby="confirmTitle">

    <h2 id="confirmTitle">
        Delete this item?
    </h2>

    <p>
        This action cannot be undone.
    </p>

    <form method="dialog">
        <button value="cancel" autofocus>
            Cancel
        </button>

        <button value="confirm">
            Delete
        </button>
    </form>

</dialog>

<script>
const deleteButton = document.getElementById('deleteItem');
const confirmDialog = document.getElementById('confirmDialog');

deleteButton.addEventListener('click', () => {
    confirmDialog.returnValue = 'cancel';
    confirmDialog.showModal();
});

confirmDialog.addEventListener('close', () => {
    if (confirmDialog.returnValue === 'confirm') {
        // Call your application deletion logic here.
        console.log('Deletion confirmed');
    }
});
</script>

Důležitý detail je, že kliknutí na tlačítko uvnitř method="dialog" formuláře zavře dialog a nastaví jeho returnValue.

Náš kód zkontroluje, zda uživatel vybral confirm.

Resetování hodnoty před otevřením zabraňuje tomu, aby dřívější potvrzení byla omylně považována za novou, pokud uživatel dialog zavře klávesou Escape.

Příklad záměrně nic nemaže. V reálné aplikaci by potvrzená akce volala váš vlastní PHP endpoint nebo aplikační kontroler, s potřebnou autorizací a CSRF ochranou.

6. Otestujte pracovní postup potvrzení

Užitečnou ukázkou je seznam uložených položek, každá s tlačítkem Smazat. Kliknutí na Smazat by mělo otevřít potvrzovací dialog. Zrušit by měl ponechat položku nezměněnou; Potvrdit by měl odstranit pouze vybranou položku.

Toto ilustruje tok potvrzení bez měnění reálných dat webu.

7. Přidejte kontaktní formulář do dialogu

Kontaktní formulář je další běžný případ použití.

Ale existuje důležitý rozdíl mezi zavřením dialogu a odesláním dat na server.

Formulář s method="dialog" zavře vyskakovací okno. Neodesílá konvenční HTTP požadavek na váš PHP backend.

Pro reálný kontaktní formulář použijte běžné odeslání formuláře nebo AJAX požadavek.

Například:

<dialog id="contactDialog"
        aria-labelledby="contactTitle">

    <h2 id="contactTitle">
        Contact us
    </h2>

    <form action="/contact-handler.php" method="post">
        <label for="contactEmail">
            Your email
        </label>

        <input
            type="email"
            id="contactEmail"
            name="email"
            required
            autocomplete="email"
            autofocus
        >

        <label for="contactMessage">
            Your message
        </label>

        <textarea
            id="contactMessage"
            name="message"
            required
        ></textarea>

        <button type="submit">
            Send message
        </button>

        <button type="button" id="closeContact">
            Cancel
        </button>
    </form>
</dialog>

Tlačítko Odeslat normálně odešle formulář.

Tlačítko Zrušit by mělo zavřít dialog bez odeslání:

document.getElementById('closeContact')
    .addEventListener('click', () => {
        document.getElementById('contactDialog').close();
    });

Váš PHP handler stále musí ověřit odeslaná data, implementovat ochranu proti spamu a vrátit smysluplnou odpověď o úspěchu nebo chybě.

Modální dialog zlepšuje rozhraní; nenahrazuje serverovou bezpečnost formulářů.

8. Můžou uživatelé zavřít dialog kliknutím venku?

Mnoho webů umožňuje návštěvníkům zavřít vyskakovací okno kliknutím na jeho pozadí.

Toto chování se často nazývá light dismiss (zavření kliknutím mimo).

Moderní HTML zahrnuje closedby atribut, který může specifikovat, zda může být dialog zavřen interakcí zvenčí, platformními požadavky na zavření nebo explicitními ovládacími prvky.

Například:

<dialog id="infoDialog" closedby="any">
    <h2>More information</h2>
    <p>Additional details appear here.</p>

    <form method="dialog">
        <button>Close</button>
    </form>
</dialog>

Hodnota closedby="any" umožňuje chování light-dismiss v prohlížečích, které ho podporují.

Podpora novějších funkcí dialogu by ale měla být zkontrolována proti vašim cílovým prohlížečům. Základní showModal() a close() API jsou více zavedená.

Pro kritické potvrzovací dialogy může být nechtěné zavření zvenčí nežádoucí.

Ve všech případech ponechejte viditelné ovládání pro zavření nebo zrušení.

9. Vyhněte se těmto běžným implementačním chybám

Technical workflow illustration

Otevření modálního dialogu přidáním open atributu

Tento kód:

dialog.setAttribute('open', '');

neposkytuje stejné chování jako:

dialog.showModal();

open atribut zobrazuje dialog nemodálně. Nezpůsobí automaticky, že zbytek dokumentu bude inertní.

Použijte showModal(), když potřebujete skutečný modální dialog.

Odebrání open atributu pro zavření modálního dialogu

Vyhněte se ručnímu odebrání open atributu z aktivního modálního dialogu.

Použijte:

dialog.close();

To následuje zamýšlený životní cyklus a zajišťuje vhodné chování při zavírání.

Použití odkazu místo tlačítka

Ovládací prvek, který otevírá akci rozhraní, by obecně měl být tlačítko:

<button type="button">Open settings</button>

Používejte odkazy pro navigaci na jiný zdroj.

Zapomenutí viditelnosti fokusu

Uživatelé navigující klávesnicí potřebují viditelnou indikaci toho, který ovládací prvek je aktivní.

Uchovávejte jasný :focus-visible styl místo odstraňování prohlížečových outline fokusu bez náhrady.

Umístění dialogu do skrytého kontejneru

Pokud je rodičovský kontejner skrytý, nebo pokud CMS dynamicky nahrazuje obklopující markup, dialog se může chovat neočekávaně.

Pro integrace s page buildery preferujte stabilní kontejner a ujistěte se, že JavaScript běží až po vložení dialogu do dokumentu.

10. Integrujte dialog do WordPressu nebo Joomly

Nemusíte vytvářet rozšíření jen pro použití nativního dialog elementu.

Pro jednoduchý web se integrace skládá ze tří částí:

Část Kam patří
HTML markup Vlastní HTML blok, modul, šablona nebo prvek page builderu
CSS Vlastní CSS tématu nebo šablony
JavaScript Podporovaná oblast skriptů tématu/šablony, child theme nebo uznávané rozšíření pro vkládání kódu, které správně zpracovává JavaScript

WordPress

Ve WordPressu můžete umístit HTML do vlastního HTML bloku, pokud váš účet a konfigurace editoru povolují potřebný markup.

Styling přidejte přes podporovaný mechanismus vlastního CSS vašeho tématu.

Pro JavaScript použijte oblast skriptů podporovanou tématem, child theme nebo uznávané rozšíření pro vkládání kódu, které správně zpracovává JavaScript.

Některé editory a bezpečnostní konfigurace filtrovají <script> elementy. Nepředpokládejte, že JavaScript vložený přímo do bloků obsahu bude proveden.

Joomla

V Joomle může vlastní modul nebo editor, který povoluje vhodný HTML markup, obsahovat dialog.

CSS přidejte do vlastního stylopisu vaší šablony, například user.css na webu založeném na Cassiopeii.

JavaScript umístěte do podporovaného umístění vlastních skriptů šablony nebo přes vhodné rozšíření.

V závislosti na nakonfigurovaném editoru a textovýchFiltrech může Joomla při ukládání obsahu odstranit určité elementy nebo atributy.

Pokud váš markup zmizí, zkontrolujte konfiguraci editoru a filtrů místo opakovaného vkládání stejného kódu.

Page buildery

Stejný princip platí pro vizuální page buildery: používejte jejich možnosti integrace HTML, CSS a JavaScriptu.

Pro dynamicky načítaný obsah inicializujte event listenery až po existenci relevantních elementů.

Pokud stránka obsahuje více dialogů, dejte každému unikátní ID.

11. Otestujte svůj modální dialog před publikováním

Dialog, který vypadá správně na desktopu, může mít stále problémy s použitelností.

Otestujte ho s myší, klávesnicí a mobilním zařízením.

Test Očekávaný výsledek
Kliknutí na otevírací tlačítko Dialog se objeví
Stisk Tab Fokus zůstane uvnitř ovládacích prvků modálního okna
Stisk Shift + Tab Reverzní klávesová navigace funguje
Stisk Escape Dialog se zavře, pokud je to povoleno
Kliknutí na Zavřít nebo Zrušit Dialog se zavře
Zavření dialogu Fokus se vrátí vhodně
Otevření na mobilu Obsah zůstane čitelný a scrollovatelný
Odeslání neplatného formuláře Validační zpětná vazba je viditelná
Odeslání platného formuláře Aplikace správně zpracuje data
Použití čtečky obrazovky Dialog má srozumitelný název

W3C technika WCAG H102 poskytuje užitečné pokyny pro validaci nativního modálního chování.

12. Kdy byste měli použít dialog místo pluginu?

Nativní dialog je obzvláště vhodný pro malé, zaměřené interakce: potvrzení, informační panely a jednoduché formuláře.

Pro složitější potřeby, jako jsou vícekrokové průvodci, pokročilé galerie nebo dialogy hluboce integrované s workflow CMS, může být vyhrazená komponenta nebo rozšíření stále snadněji udržitelnou volbou.

Výhodou nativního přístupu je, že poskytuje solidní základ podporovaný prohlížečem bez zavedení další JavaScript závislosti.

Také snižuje množství vlastní správy fokusu a klávesové navigace, kterou musíte implementovat sami.

Závěr: začněte se vestavěnými schopnostmi prohlížeče

Modální dialog nemusí vyžadovat velkou JavaScript knihovnu.

Nativní HTML <dialog> element poskytuje efektivní základ pro přístupná vyskakovací okna, potvrzovací zprávy a formuláře.

S showModal(), close(), method="dialog" a několika CSS pravidly můžete vytvořit rozhraní, které funguje napříč moderními prohlížeči a zároveň těží z vestavěného fokusu a klávesového chování.

Pro WordPress, Joomlu a vlastní PHP weby to může být efektivní alternativa k instalaci dalšího pluginu pro relativně jednoduchou interakci.

Klíčem je správně použít nativní chování, poskytnout jasné ovládání a otestovat výsledek s reálnými klávesovými a mobilními interakcemi.

Oficiální a technické reference