Come creare dialoghi modali accessibili con HTML, CSS e JavaScript
Crea dialoghi modali accessibili utilizzando l'elemento dialog nativo HTML. Impara come aprire e chiudere popup, gestire il focus da tastiera, stilizzare le sovrapposizioni e creare dialoghi di conferma senza una libreria JavaScript.
Come creare finestre di dialogo modali accessibili con HTML, CSS e JavaScript
Un visitatore fa clic su un pulsante del tuo sito web. Compare un popup con un modulo, un messaggio di conferma o informazioni aggiuntive.
Creare il popup visivo è facile. Farlo funzionare correttamente con una tastiera, uno screen reader e un browser mobile è un'altra questione.
Molte implementazioni personalizzate di finestre modali si basano su grandi quantità di JavaScript per gestire il focus, bloccare l'interazione con la pagina e gestire il tasto Escape.
L'HTML moderno offre un approccio più semplice: l'elemento nativo <dialog>.
Fornisce gran parte del comportamento atteso da una finestra di dialogo modale direttamente nel browser. Puoi creare un popup funzionale con una piccola quantità di HTML, CSS e JavaScript, senza installare un framework o un plugin.
In questo tutorial, creeremo una finestra modale riutilizzabile, la stilizzeremo, aggiungeremo una finestra di dialogo di conferma ed esploreremo i dettagli di accessibilità che contano nei siti web reali.
1. Che cosa rende una finestra di dialogo modale diversa da un popup normale?
Una finestra di dialogo modale richiede temporaneamente al visitatore di interagire con una parte specifica dell'interfaccia prima di tornare alla pagina principale.
Esempi tipici includono:
- Confermare l'eliminazione di un elemento.
- Visualizzare un modulo di contatto.
- Chiedere conferma prima di lasciare una pagina.
- Mostrare informazioni aggiuntive sul prodotto.
- Modificare un'impostazione dell'applicazione.
Una finestra modale implementata correttamente dovrebbe rendere chiaro il proprio scopo, offrire un modo ovvio per chiuderla e gestire adeguatamente il focus da tastiera.
L'elemento nativo <dialog> supporta sia il comportamento modale sia quello non modale.
| Metodo | Comportamento |
|---|---|
showModal() |
Apre una finestra modale e rende inerte il resto del documento |
show() |
Apre una finestra di dialogo non modale |
close() |
Chiude la finestra di dialogo |
method="dialog" |
Consente a un pulsante di un modulo di chiudere la finestra di dialogo |
Il comportamento modale include la gestione del focus e l'interazione da tastiera fornite dal browser.
2. Crea la tua prima finestra modale HTML
Iniziamo con un esempio semplice: un pulsante che apre una finestra di dialogo contenente un titolo, del testo e un pulsante di chiusura.
<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>
È sufficiente per creare una finestra di dialogo modale funzionante.
Quando il visitatore fa clic sul pulsante, showModal() apre la finestra di dialogo sopra il contenuto della pagina.
Il browser gestisce automaticamente diversi comportamenti importanti:
- La finestra di dialogo entra nel livello superiore, sopra il normale contenuto della pagina.
- Il resto del documento diventa inerte.
- Il focus da tastiera si sposta nella finestra di dialogo.
- Premere Escape normalmente la chiude.
- Il focus normalmente ritorna al pulsante di apertura quando la finestra di dialogo viene chiusa.
Il pulsante di chiusura usa method="dialog", quindi non richiede un gestore di eventi JavaScript.
3. Stilizza la finestra di dialogo con CSS
La finestra di dialogo predefinita funziona, ma il suo aspetto è basilare.
Possiamo darle angoli arrotondati, spaziatura confortevole, una larghezza responsive e uno sfondo.
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;
}
Lo pseudo-elemento ::backdrop stilizza il livello dietro una finestra di dialogo modale.
Compare solo quando la finestra di dialogo viene visualizzata in modo modale, ad esempio tramite showModal().
Una finestra di dialogo aperta con show() non riceve automaticamente lo stesso comportamento di sfondo modale.
Perché usare il livello superiore?
I popup personalizzati tradizionali spesso si basano su valori z-index sempre più grandi.
Una finestra di dialogo modale aperta con showModal() entra nel livello superiore del browser, il che evita molti problemi di contesto di impilamento.
Questo è particolarmente utile su siti web che contengono intestazioni fisse, widget fluttuanti e page builder complessi.
4. Comprendere l'accessibilità da tastiera
Una finestra modale deve funzionare senza mouse.
Immagina un visitatore che naviga nel tuo sito web usando il tasto Tab. Quando si apre una finestra modale, dovrebbe essere in grado di interagire con i suoi controlli senza spostarsi accidentalmente nella pagina sottostante.
La finestra di dialogo modale nativa aiuta in questo comportamento.
Il W3C descrive l'elemento dialog HTML come una tecnica per creare finestre di dialogo modali accessibili, incluso il contenimento del focus e il ritorno del focus quando la finestra di dialogo viene chiusa.
Assegna alla finestra di dialogo un nome accessibile
Usa un'intestazione visibile e riferiscila con aria-labelledby:
<dialog aria-labelledby="settingsTitle">
<h2 id="settingsTitle">Account settings</h2>
...
</dialog>
Questo fornisce alle tecnologie assistive un nome significativo per la finestra di dialogo.
Scegli con attenzione il focus iniziale
L'attributo autofocus può identificare il controllo che dovrebbe ricevere il focus quando si apre la finestra modale.
Per una finestra di dialogo informativa, potrebbe essere appropriato impostare il focus sul pulsante di chiusura.

Per un modulo, potrebbe avere più senso impostare il focus sul primo campo di input.
Per una conferma distruttiva, spesso è preferibile impostare il focus sull'azione più sicura, come Annulla.
Evita di inserire tabindex direttamente sull'elemento <dialog>; la specifica HTML vieta quell'attributo sull'elemento stesso.
Fornisci sempre un pulsante di chiusura visibile
Anche se Escape normalmente chiude una finestra di dialogo modale, un controllo di chiusura visibile rimane essenziale.
I visitatori da mobile potrebbero non avere una tastiera fisica, e alcuni utenti non sapranno che Escape può chiudere un popup.
5. Crea una finestra di dialogo di conferma con due pulsanti
Ora creiamo un esempio più utile: confermare l'eliminazione di un elemento salvato.
Il visitatore dovrebbe poter scegliere Annulla o Elimina.
L'HTML fornisce un meccanismo conveniente tramite method="dialog" e la proprietà returnValue della finestra di dialogo.
<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>
Il dettaglio importante è che fare clic su un pulsante all'interno di un modulo method="dialog" chiude la finestra di dialogo e ne imposta il returnValue.
Il nostro codice verifica se l'utente ha selezionato confirm.
Reimpostare il valore prima dell'apertura impedisce che una conferma precedente venga scambiata per una nuova se l'utente chiude la finestra di dialogo con Escape.
L'esempio non elimina intenzionalmente nulla. In un'applicazione reale, l'azione confermata chiamerebbe il tuo endpoint PHP o controller dell'applicazione, con le necessarie autorizzazioni e protezioni CSRF.
6. Testa il flusso di conferma
Una dimostrazione utile è un elenco di elementi salvati, ciascuno con un pulsante Elimina. Facendo clic su Elimina dovrebbe aprirsi una finestra di dialogo di conferma. Annulla dovrebbe lasciare l'elemento invariato; Conferma dovrebbe rimuovere solo l'elemento selezionato.
Questo illustra il flusso di conferma senza modificare i dati reali del sito web.
7. Aggiungi un modulo di contatto all'interno di una finestra di dialogo
Un modulo di contatto è un altro caso d'uso comune.
Ma c'è un'importante differenza tra chiudere una finestra di dialogo e inviare dati a un server.
Un modulo con method="dialog" chiude il popup. Non invia una richiesta HTTP convenzionale al tuo backend PHP.
Per un vero modulo di contatto, usa un invio normale del modulo o una richiesta AJAX.
Per esempio:
<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>
Il pulsante Invia invia il modulo normalmente.
Il pulsante Annulla dovrebbe chiudere la finestra di dialogo senza inviare:
document.getElementById('closeContact')
.addEventListener('click', () => {
document.getElementById('contactDialog').close();
});
Il tuo handler PHP deve comunque validare i dati inviati, implementare protezioni anti-spam e restituire una risposta significativa di successo o errore.
Una finestra di dialogo modale migliora l'interfaccia; non sostituisce la sicurezza dei moduli lato server.
8. Gli utenti possono chiudere la finestra di dialogo facendo clic all'esterno?
Molti siti web consentono ai visitatori di chiudere un popup facendo clic sul suo sfondo.
Questo comportamento è spesso chiamato light dismiss.
L'HTML moderno include l'attributo closedby, che può specificare se una finestra di dialogo può essere chiusa tramite interazione esterna, richieste di chiusura della piattaforma o controlli espliciti.
Per esempio:
<dialog id="infoDialog" closedby="any">
<h2>More information</h2>
<p>Additional details appear here.</p>
<form method="dialog">
<button>Close</button>
</form>
</dialog>
Il valore closedby="any" consente il comportamento light-dismiss nei browser che lo supportano.
Tuttavia, il supporto per le funzionalità più recenti della finestra di dialogo dovrebbe essere verificato rispetto ai browser di destinazione. Le API di base showModal() e close() sono più ampiamente consolidate.
Per finestre di dialogo di conferma critiche, la chiusura accidentale facendo clic all'esterno potrebbe essere indesiderabile.
In tutti i casi, mantieni un controllo visibile di chiusura o annullamento.
9. Evita questi errori di implementazione comuni

Aprire una finestra modale aggiungendo l'attributo open
Questo codice:
dialog.setAttribute('open', '');
non fornisce lo stesso comportamento di:
dialog.showModal();
L'attributo open visualizza la finestra di dialogo in modo non modale. Non rende automaticamente inerte il resto del documento.
Usa showModal() quando hai bisogno di una vera finestra modale.
Rimuovere l'attributo open per chiudere una finestra modale
Evita di rimuovere manualmente l'attributo open da una finestra modale attiva.
Usa:
dialog.close();
Questo segue il ciclo di vita previsto e garantisce il comportamento di chiusura appropriato.
Usare un link invece di un pulsante
Un controllo che avvia un'azione dell'interfaccia dovrebbe generalmente essere un pulsante:
<button type="button">Open settings</button>
Usa i link per la navigazione verso un'altra risorsa.
Dimenticare la visibilità del focus
Gli utenti che navigano con una tastiera hanno bisogno di un'indicazione visibile di quale controllo è attivo.
Mantieni uno stile :focus-visible chiaro invece di rimuovere i contorni del focus del browser senza sostituirli.
Posizionare la finestra di dialogo all'interno di un contenitore nascosto
Se un contenitore padre è nascosto, o se un CMS sostituisce dinamicamente il markup circostante, la finestra di dialogo potrebbe comportarsi in modo imprevisto.
Per le integrazioni con page builder, preferisci un contenitore stabile e assicurati che il JavaScript venga eseguito dopo che la finestra di dialogo è stata inserita nel documento.
10. Integrare una finestra di dialogo in WordPress o Joomla
Non è necessario creare un'estensione solo per usare l'elemento dialog nativo.
Per un sito web semplice, l'integrazione consiste in tre parti:
| Parte | Dove va |
|---|---|
| Markup HTML | Blocco HTML personalizzato, modulo, template o elemento del page builder |
| CSS | CSS personalizzato del tema o del template |
| JavaScript | JavaScript personalizzato del tema/template o una funzionalità supportata di iniezione di codice |
WordPress
In WordPress, puoi inserire l'HTML in un blocco HTML personalizzato, a condizione che il tuo account e la configurazione dell'editor consentano il markup necessario.
Aggiungi lo stile tramite il meccanismo supportato dal tuo tema per il CSS personalizzato.
Per il JavaScript, usa un'area script supportata dal tema, un tema child o un'estensione affidabile per l'inserimento di codice che gestisca correttamente JavaScript.
Alcuni editor e configurazioni di sicurezza filtrano gli elementi <script>. Evita di dare per scontato che il JavaScript incollato direttamente in un blocco di contenuto venga eseguito.
Joomla
In Joomla, un modulo personalizzato o un editor che consente un markup HTML adeguato può contenere la finestra di dialogo.
Aggiungi il CSS al foglio di stile personalizzato del tuo template, come user.css in un sito basato su Cassiopeia.
Inserisci JavaScript nella posizione supportata dal template per gli script personalizzati o tramite un'estensione adeguata.
A seconda dell'editor configurato e dei filtri di testo, Joomla potrebbe rimuovere determinati elementi o attributi quando il contenuto viene salvato.
Se il tuo markup scompare, controlla la configurazione dell'editor e dei filtri invece di incollare ripetutamente lo stesso codice.
Page builder
Lo stesso principio vale per i page builder visuali: usa le loro capacità di integrazione di HTML, CSS e JavaScript.
Per i contenuti caricati dinamicamente, inizializza i listener di eventi solo dopo che gli elementi pertinenti esistono.
Se una pagina contiene più finestre di dialogo, assegna a ciascuna un ID univoco.
11. Testa la tua finestra modale prima di pubblicare
Una finestra di dialogo che sembra corretta su desktop può comunque avere problemi di usabilità.
Testala con mouse, tastiera e dispositivo mobile.
| Test | Risultato atteso |
|---|---|
| Fai clic sul pulsante di apertura | La finestra di dialogo appare |
| Premi Tab | Il focus rimane all'interno dei controlli della finestra modale |
| Premi Shift + Tab | La navigazione inversa da tastiera funziona |
| Premi Escape | La finestra di dialogo si chiude quando consentito |
| Fai clic su Chiudi o Annulla | La finestra di dialogo si chiude |
| Chiudi la finestra di dialogo | Il focus ritorna in modo appropriato |
| Apri su mobile | Il contenuto rimane leggibile e scorrevole |
| Invia un modulo non valido | Il feedback di validazione è visibile |
| Invia un modulo valido | L'applicazione gestisce correttamente i dati |
| Usa uno screen reader | La finestra di dialogo ha un nome comprensibile |
La tecnica WCAG H102 del W3C fornisce utili indicazioni per validare il comportamento modale nativo.
12. Quando dovresti usare una finestra di dialogo invece di un plugin?
Una finestra di dialogo nativa è particolarmente adatta per interazioni piccole e mirate: conferme, pannelli informativi e moduli semplici.
Per esigenze più complesse, come procedure guidate a più passaggi, gallerie avanzate o finestre di dialogo profondamente integrate con un flusso di lavoro CMS, un componente o un'estensione dedicati potrebbero comunque essere l'opzione più manutenibile.
Il vantaggio dell'approccio nativo è che fornisce una solida base supportata dal browser senza introdurre un'altra dipendenza JavaScript.
Riduce anche la quantità di gestione personalizzata del focus e della tastiera che devi implementare da solo.
Conclusione: inizia con le capacità integrate del browser
Una finestra di dialogo modale non deve necessariamente richiedere una grande libreria JavaScript.
L'elemento nativo HTML <dialog> fornisce una base efficace per popup accessibili, messaggi di conferma e moduli.
Con showModal(), close(), method="dialog" e alcune regole CSS, puoi creare un'interfaccia che funziona su browser moderni beneficiando del comportamento integrato di focus e tastiera.
Per WordPress, Joomla e siti web PHP personalizzati, questa può essere un'alternativa efficiente all'installazione di un altro plugin per un'interazione relativamente semplice.
La chiave è usare correttamente il comportamento nativo, fornire controlli chiari e testare il risultato con interazioni reali da tastiera e mobile.