Web și dezvoltare

Cum să creați dialoguri modale accesibile cu HTML, CSS și JavaScript

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

Construiți dialoguri modale accesibile folosind elementul nativ dialog HTML. Învață cum să deschideți și să închideți popup-uri, să gestionați focalizarea tastaturii, să stilizați fundalurile și să creați dialoguri de confirmare fără o bibliotecă JavaScript.

Cum să creezi ferestre modale accesibile cu HTML, CSS și JavaScript

Un vizitator dă clic pe un buton pe site-ul tău. Apare un popup cu un formular, un mesaj de confirmare sau informații suplimentare.

Crearea popup-ului vizual este ușoară. Făcarea acestuia să funcționeze corect cu un tastatură, un cititor de ecran și un browser mobil este o altă problemă.

Multe implementări custom de modale se bazează pe cantități mari de JavaScript pentru a gestiona focusul, pentru a bloca interacțiunea cu pagina și pentru a gestiona tasta Escape.

HTML-ul modern oferă o abordare mai simplă: elementul nativ <dialog>.

Acesta oferă mult din comportamentul așteptat de la o fereastră modală direct în browser. Poți crea un popup funcțional cu o cantitate mică de HTML, CSS și JavaScript, fără a instala un framework sau un plugin.

În acest tutorial, vom construi o modal reutilizabilă, o vom stiliza, vom adăuga o fereastră de confirmare și vom explora detaliile de accesibilitate care contează în site-urile web reale.

1. Ce face o fereastră modală diferită de un popup obișnuit?

O fereastră modală necesită temporar ca vizitatorul să interacționeze cu o anumită parte a interfeței înainte de a reveni la pagina principală.

Exemple tipice includ:

  • Confirmarea ștergerii unui element.
  • Afișarea unui formular de contact.
  • Solicitarea unei confirmări înainte de a părăsi o pagină.
  • Afișarea unor informații suplimentare despre un produs.
  • Editarea unei setări a unei aplicații.

O modal implementată corect ar trebui să își clarifice scopul, să ofere o modalitate evidentă de închidere și să gestioneze focusul tastaturii în mod corespunzător.

Elementul nativ <dialog> suportă atât comportamentul modal, cât și pe cel non-modal.

Metodă Comportament
showModal() Deschide o modală și face restul documentului inert
show() Deschide o fereastră non-modală
close() Închide fereastra
method="dialog" Permite unui buton de formular să închidă fereastra

Comportamentul modal include gestionarea focusului și interacțiunea cu tastatura furnizată de browser.

2. Creează prima ta modal HTML

Să începem cu un exemplu simplu: un buton care deschide o fereastră conținând un titlu, un text și un buton de închidere.

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

Este suficient pentru a crea o fereastră modală funcțională.

Când vizitatorul dă clic pe buton, showModal() deschide fereastra deasupra conținutului paginii.

Browserul gestionează automat mai multe comportamente importante:

  • Fereastra intră în stratul superior (top layer), deasupra conținutului obișnuit al paginii.
  • Restul documentului devine inert.
  • Focusul tastaturii se mută în fereastră.
  • Apăsarea tastei Escape o închide în mod normal.
  • Focusul revine de obicei la butonul care a deschis fereastra atunci când aceasta se închide.

Butonul de închidere folosește method="dialog", astfel încât nu necesită un handler de eveniment JavaScript.

3. Stilizează fereastra cu CSS

Fereastra implicită funcționează, dar aspectul său este de bază.

Îi putem oferi colțuri rotunjite, spațiere confortabilă, o lățime responsivă și un fundal (backdrop).

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;
}

Pseudo-elementul ::backdrop stilizează stratul din spatele unei ferestre modale.

Acesta apare doar atunci când fereastra este afișată în mod modal, cum ar fi prin showModal().

O fereastră deschisă cu show() nu primește automat același comportament de fundal modal.

De ce să folosești stratul superior (top layer)?

Popup-urile custom tradiționale se bazează adesea pe valori z-index din ce în ce mai mari.

O fereastră modală deschisă cu showModal() intră în stratul superior al browserului, ceea ce evită multe probleme de context de stivuire (stacking context).

Acest lucru este deosebit de util pe site-urile care conțin headere fixe (sticky), widget-uri plutitoare și constructori de pagini complexe.

4. Înțelege accesibilitatea prin tastatură

O modală trebuie să funcționeze fără mouse.

Imaginează-ți un vizitator care navighează pe site-ul tău folosind tasta Tab. Când o modală se deschide, acesta ar trebui să poată interacționa cu controalele acesteia fără a se muta accidental în pagina din spate.

Fereastra modală nativă ajută la acest comportament.

W3C descrie elementul HTML dialog ca o tehnică pentru crearea de ferestre modale accesibile, inclusiv limitarea focusului și returnarea acestuia atunci când fereastra se închide.

Oferă ferestrei un nume accesibil

Folosește un titlu vizibil și referă-te la acesta cu aria-labelledby:

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

Acest lucru oferă tehnologiilor asistente un nume semnificativ pentru fereastră.

Alege focusul inițial cu atenție

Atributul autofocus poate identifica controlul care ar trebui să primească focusul atunci când modala se deschide.

Pentru o fereastră informativă, poate fi appropriate să pui focusul pe butonul de închidere.

Illustration of the article's main concept

Pentru un formular, poate avea mai mult sens să pui focusul pe primul input.

Pentru o confirmare de acțiune distructivă, este adesea preferabil să pui focusul pe acțiunea mai sigură, cum ar fi „Anulează”.

Evită plasarea tabindex direct pe elementul <dialog>; specificația HTML interzice acel atribut pe elementul în sine.

Oferă întotdeauna un buton de închidere vizibil

Deși tasta Escape închide în mod normal o fereastră modală, un control de închidere vizibil rămâne esențial.

Vizitatorii de pe dispozitive mobile pot să nu aibă o tastatură fizică, iar unii utilizatori nu vor ști că tasta Escape poate dispensa un popup.

5. Creează o fereastră de confirmare cu două butoane

Acum să construim un exemplu mai util: confirmarea ștergerii unui element salvat.

Vizitatorul ar trebui să poată alege „Anulează” sau „Șterge”.

HTML oferă un mecanism convenabil prin method="dialog" și proprietatea returnValue a ferestrei.

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

Detaliul important este că apăsarea unui buton în interiorul unui formular method="dialog" închide fereastra și îi setează returnValue.

Codul nostru verifică dacă utilizatorul a selectat confirm.

Resetarea valorii înainte de deschidere previne confundarea unei confirmări anterioare cu una nouă, dacă utilizatorul dispensează fereastra cu Escape.

Exemplul nu șterge nimic în mod intenționat. Într-o aplicație reală, acțiunea confirmată ar apela propriul tău endpoint PHP sau controller de aplicație, cu autorizarea necesară și protecțiile CSRF.

6. Testează fluxul de confirmare

O demonstrație utilă este o listă de elemente salvate, fiecare cu un buton „Șterge”. Apăsarea pe „Șterge” ar trebui să deschidă o fereastră de confirmare. „Anulează” ar trebui să lase elementul neatingut; „Confirmă” ar trebui să elimine doar elementul selectat.

Acest lucru ilustrează fluxul de confirmare fără a modifica datele reale ale site-ului web.

7. Adaugă un formular de contact în interiorul unei ferestre

Un formular de contact este un alt caz de utilizare comun.

Dar există o diferență importantă între închiderea unei ferestre și trimiterea datelor către un server.

Un formular cu method="dialog" închide popup-ul. Acesta nu trimite o cerere HTTP convențională către backend-ul tău PHP.

Pentru un formular de contact real, folosește o trimitere normală de formular sau o cerere AJAX.

De exemplu:

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

Butonul „Trimite” trimite formularul în mod normal.

Butonul „Anulează” ar trebui să închidă fereastra fără a trimite datele:

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

Handler-ul tău PHP trebuie în continuare să valideze datele trimise, să implementeze protecția anti-spam și să returneze un răspuns de succes sau eroare semnificativ.

O fereastră modală îmbunătățește interfața; ea nu înlocuiește securitatea formularului de pe partea de server.

8. Pot utilizatorii să închidă fereastra apăsând în exterior?

Multe site-uri web permit vizitatorilor să dispense un popup apăsând pe fundalul acestuia (backdrop).

Acest comportament este adesea numit light dismiss.

HTML-ul modern include atributul closedby, care poate specifica dacă o fereastră poate fi dispensată printr-o interacțiune externă, cereri de închidere de la platformă sau controale explicite.

De exemplu:

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

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

Valoarea closedby="any" permite comportamentul de light-dismiss în browserele care îl suportă.

Totuși, suportul pentru noile funcții de dialog trebuie verificat în funcție de browserele tale țintă. API-urile de bază showModal() și close() sunt mult mai bine stabilite.

Pentru ferestrele de confirmare critice, dispensa accidentală în exterior poate fi nedorită.

În toate cazurile, păstrează un control de închidere sau anulare vizibil.

9. Evită aceste greșeli comune de implementare

Technical workflow illustration

Deschiderea unei modale prin adăugarea atributului open

Acest cod:

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

nu oferă același comportament ca:

dialog.showModal();

Atributul open afișează fereastra într-un mod non-modal. Acesta nu face automat restul documentului inert.

Folosește showModal() atunci când ai nevoie de o modală propriu-zisă.

Eliminarea atributului „open” pentru a închide o modală

Evită eliminarea manuală a atributului open dintr-o modală activă.

Folosește:

dialog.close();

Acest lucru urmează ciclul de viață prevăzut și asigură comportamentul de închidere corespunzător.

Utilizarea unui link în loc de un buton

Un control care deschide o acțiune în interfață ar trebui, în general, să fie un buton:

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

Folosește link-uri pentru navigarea către o altă resursă.

Uitarea vizibilității focusului

Utilizatorii care navighează cu tastatura au nevoie de o indicație vizibilă a controlului care este activ.

Păstrează un stil :focus-visible clar în loc să elimini conturul de focus al browserului fără a-l înlocui.

Plasarea ferestrei în interiorul unui container ascuns

Dacă un container părinte este ascuns sau dacă un CMS înlocuiește dinamic markup-ul înconjurător, fereastra poate se comporta neașteptat.

Pentru integrările cu constructori de pagini (page builders), preferă un container stabil și asigură-te că JavaScript-ul rulează după ce fereastra a fost inserată în document.

10. Integrează o fereastră în WordPress sau Joomla

Nu trebuie să creezi o extensie doar pentru a folosi elementul dialog nativ.

Pentru un site web simplu, integrarea constă în trei părți:

Partea Unde se pune
Markup HTML Bloc Custom HTML, modul, template sau element de page-builder
CSS Custom CSS pentru temă sau template
JavaScript Custom JavaScript pentru temă/template sau o funcție de injecție de cod suportată

WordPress

În WordPress, poți plasa HTML-ul într-un bloc Custom HTML, cu condiția ca contul și configurarea editorului tău să permită markup-ul necesar.

Adaugă stilizarea prin mecanismul de custom CSS suportat de tema ta.

Pentru JavaScript, folosește o zonă de script suportată de temă, un child theme sau o extensie de inserare de cod de renume care gestionează corect JavaScript-ul.

Unele editoare și configurații de securitate filtrează elementele <script>. Evită să presupui că un JavaScript lipit direct într-un bloc de conținut va fi executat.

Joomla

În Joomla, un modul Custom sau un editor care permite un markup HTML adecvat poate conține fereastra.

Adaugă CSS-ul în foaia de stil custom a template-ului tău, cum ar fi user.css într-un site bazat pe Cassiopeia.

Plasează JavaScript-ul în locația de script custom suportată a template-ului sau printr-o extensie potrivită.

În funcție de editorul și filtrele de text configurate, Joomla poate elimina anumite elemente sau atribute atunci când conținutul este salvat.

Dacă markup-ul tău dispare, inspectează configurația editorului și a filtrelor, în loc să lipești repetat același cod.

Page builders

Același principiu se aplică și constructorilor vizuali de pagini: folosește capacitățile lor de integrare HTML, CSS și JavaScript.

Pentru conținutul încărcat dinamic, inițializează ascultătorii de evenimente (event listeners) numai după ce elementele relevante există.

Dacă o pagină conține mai multe ferestre, oferă fiecăreia un ID unic.

11. Testează modalul înainte de publicare

O fereastră care pare corectă pe desktop poate avea totuși probleme de utilizare.

Testează-o cu un mouse, tastatură și dispozitiv mobil.

Test Rezultat așteptat
Click pe butonul de deschidere Fereastra apare
Apasă Tab Focusul rămâne în cadrul controalelor modalei
Apasă Shift + Tab Navigarea inversă cu tastatura funcționează
Apasă Escape Fereastra se închide când este permis
Click pe Închide sau Anulează Fereastra se închide
Închide fereastra Focusul revine corespunzător
Deschide pe mobil Conținutul rămâne lizibil și scrollabil
Trimite un formular invalid Feedback-ul de validare este vizibil
Trimite un formular valid Aplicația gestionează datele corect
Folosește un cititor de ecran Fereastra are un nume inteligibil

Tehnica WCAG H102 de la W3C oferă îndrumări utile pentru validarea comportamentului nativ al modalelor.

12. Când ar trebui să folosești o fereastră în loc de un plugin?

O fereastră nativă este deosebit de potrivită pentru interacțiuni mici și specifice: confirmări, panouri informative și formulare simple.

Pentru nevoi mai complexe, cum ar fi asistenți multi-pas (wizards), galerii avansate sau ferestre integrate profund într-un flux de lucru CMS, un component sau o extensie dedicată poate rămâne opțiunea mai ușor de întreținut.

Avantajul abordării native este că oferă o fundație solidă, suportată de browser, fără a introduce o altă dependență de JavaScript.

De asemenea, reduce cantitatea de gestionare custom a focusului și a tastaturii pe care trebuie să o implementezi singur.

Concluzie: începe cu capacitățile integrate ale browserului

O fereastră modală nu trebuie să necesite o librărie JavaScript mare.

Elementul nativ HTML <dialog> oferă o fundație eficientă pentru popup-uri accesibile, mesaje de confirmare și formulare.

Cu showModal(), close(), method="dialog" și câteva reguli CSS, poți crea o interfață care funcționează în browserele moderne, beneficiind în același timp de comportamentul integrat de focus și tastatură.

Pentru WordPress, Joomla și site-uri web custom PHP, aceasta poate fi o alternativă eficientă la instalarea unui alt plugin pentru o interacțiune relativ simplă.

Cheia este să folosești comportamentul nativ în mod corect, să oferi controale clare și să testezi rezultatul cu interacțiuni reale de tastatură și pe mobil.

Referințe oficiale și tehnice