4.1 L’elemento <dialog>
In HTML5 è comparso anche l’elemento <dialog>, pensato per creare finestre di dialogo e finestre modali nelle pagine web. Questo elemento permette di creare finestre pop-up in modo semplice e semanticamente corretto per vari scopi: notifiche, conferme, moduli di inserimento e molto altro. Qui sotto vedremo come usare <dialog>, i suoi attributi e metodi, oltre ad alcuni esempi d’uso.
L’elemento <dialog> rappresenta una finestra di dialogo o un’altra finestra interattiva. Può essere sia modale che non modale. Dentro l’elemento <dialog> puoi inserire qualsiasi contenuto HTML: testo, moduli, pulsanti e così via.
Sintassi:
<dialog>
<!-- Contenuto della finestra di dialogo -->
</dialog>
<div style="min-height: 200px;">
<dialog id="favSuperHeroDialog">
<form method="dialog">
<div>
<label for="favSuperHero">Supereroe preferito:</label>
<select id="favSuperHero" name="favSuperHero">
<option></option>
<option>Capitan America</option>
<option>Iron Man</option>
<option>Hulk</option>
</select>
</div>
<div>
<button type="reset" id="cancel">Reimposta</button>
<button type="submit">Conferma</button>
</div>
</form>
</dialog>
<button id="updateDetails">Apri la finestra di dialogo</button>
</div>
<dialog id="favSuperHeroDialog">
<form method="dialog">
<div>
<label for="favSuperHero">Supereroe preferito:</label>
<select id="favSuperHero" name="favSuperHero">
<option></option>
<option>Capitan America</option>
<option>Iron Man</option>
<option>Hulk</option>
</select>
</div>
<div>
<button type="reset" id="cancel">Reimposta</button>
<button type="submit">Conferma</button>
</div>
</form>
</dialog>
<button id="updateDetails">Apri la finestra di dialogo</button>
// Recuperiamo i pulsanti e il dialogo dal DOM
const updateButton = document.getElementById("updateDetails");
const cancelButton = document.getElementById("cancel");
const dialog = document.getElementById("favSuperHeroDialog");
// Funzione che controlla lo stato del dialogo (aperto/chiuso)
function openCheck(dialog) {
if (dialog.open) {
console.log("Dialogo avviato");
} else {
console.log("Dialogo terminato");
}
}
// Apriamo il dialogo al clic sul pulsante Update
updateButton.addEventListener("click", () => {
dialog.showModal();
openCheck(dialog);
});
// Chiudiamo il dialogo al clic sul pulsante Cancel
cancelButton.addEventListener("click", () => {
dialog.close();
openCheck(dialog);
});
4.2 Attributi e metodi di <dialog>
L’attributo open indica se la finestra di dialogo è aperta. Se questo attributo è presente, il dialogo viene mostrato sulla pagina.
Esempio d’uso dell’attributo open:
<dialog open>
<p>Questa è una finestra di dialogo aperta.</p>
</dialog>
Una finestra mostrata tramite l’attributo open è sempre non modale. La finestra modale si apre con il metodo showModal() (ne parliamo più sotto).
La proprietà returnValue contiene una stringa con il risultato: il valore con cui è stata chiusa la finestra. È una proprietà dell’oggetto JavaScript del dialogo, non un attributo HTML, quindi nel markup non si scrive. Il valore lo imposta il metodo close('valore') oppure un pulsante di un modulo con method="dialog": in quel caso in returnValue finisce il value del pulsante premuto. Se la finestra è stata chiusa con il tasto Esc, returnValue non cambia.
dialog.close('confirm');
console.log(dialog.returnValue); // "confirm"
Metodo show():
Apre la finestra di dialogo in modalità non modale.
dialog.show();
Metodo showModal():
Apre la finestra di dialogo in modalità modale, bloccando l’interazione con il resto della pagina.
dialog.showModal();
Metodo close():
Chiude la finestra di dialogo.
dialog.close();
Come «collegare» un metodo a un pulsante: il minimo di JavaScript
L’attributo open mostra la finestra subito, al caricamento della pagina. Perché la finestra si apra e si chiuda con un pulsante, in questa lezione chiamiamo i metodi show(), showModal() e close() da JavaScript: sono proprio quelli che servono negli esercizi. Il linguaggio lo vedremo in dettaglio più avanti, per ora basta questo modello:
<button id="btn-open">Mostra suggerimento</button>
<dialog id="info-dialog">
<p>Testo della finestra</p>
<button id="btn-close">Ho capito</button>
</dialog>
<script>
// 1. Troviamo gli elementi della pagina tramite il loro id
const openBtn = document.getElementById('btn-open');
const closeBtn = document.getElementById('btn-close');
const infoDialog = document.getElementById('info-dialog');
// 2. «Quando qualcuno clicca sul pulsante, esegui il codice tra parentesi graffe»
openBtn.addEventListener('click', () => {
infoDialog.showModal(); // apri in modalità modale
});
closeBtn.addEventListener('click', () => {
infoDialog.close(); // chiudi
});
</script>
<script>lo mettiamo alla fine di<body>: il browser esegue lo script appena ci arriva, e gli elementi sotto lo script non esistono ancora, quindigetElementByIdrestituirebbenull.document.getElementById('…')vuol dire «dammi l’elemento con questo id».elemento.addEventListener('click', () => { … })vuol dire «quando qualcuno clicca sull’elemento, esegui il codice tra parentesi». La scrittura() => { … }è una funzione breve: codice che verrà eseguito più tardi, al clic.- Per una finestra non modale, al posto di
showModal()chiamashow().
4.3 Eventi di <dialog>
Evento close:
Evento che si verifica quando la finestra di dialogo viene chiusa.
<div style="min-height: 200px">
<dialog id="myDialog">
<form method="dialog">
<p>Premi il pulsante "Annulla" o "OK" per restituire un valore</p>
<div class="dialog-buttons">
<button value="cancel">Annulla</button>
<button value="confirm">OK</button>
</div>
</form>
</dialog>
<button id="showDialog">Mostra la finestra di dialogo</button>
</div>
<dialog id="myDialog">
<form method="dialog">
<p>Premi il pulsante "Annulla" o "OK" per restituire un valore</p>
<div class="dialog-buttons">
<button value="cancel">Annulla</button>
<button value="confirm">OK</button>
</div>
</form>
</dialog>
<button id="showDialog">Mostra la finestra di dialogo</button>
// Recuperiamo gli elementi del DOM
const dialog = document.getElementById('myDialog');
const showDialogButton = document.getElementById('showDialog');
// Apertura della finestra modale
showDialogButton.addEventListener('click', () => {
dialog.showModal();
});
// Alla chiusura mostriamo returnValue
dialog.addEventListener('close', () => {
alert(`Dialogo chiuso con il valore restituito: ${dialog.returnValue}`);
});
Evento cancel:
Evento che si verifica quando la finestra di dialogo viene annullata (ad esempio, premendo il tasto Esc).
<div style="min-height: 200px">
<dialog id="myDialog">
<form method="dialog">
<p>Premi il tasto "Esc" per vedere il risultato</p>
</form>
</dialog>
<button id="showDialog">Apri la finestra di dialogo</button>
</div>
<dialog id="myDialog">
<form method="dialog">
<p>Premi il tasto "Esc" per vedere il risultato</p>
</form>
</dialog>
<button id="showDialog">Apri la finestra di dialogo</button>
// Recuperiamo gli elementi del DOM
const dialog = document.getElementById('myDialog');
const showDialogButton = document.getElementById('showDialog');
// Apertura del dialogo
showDialogButton.addEventListener("click", () => {
dialog.showModal();
});
// Gestione dell’annullamento del dialogo (tasto Esc)
dialog.addEventListener('cancel', () => {
alert('Dialog was cancelled');
});
GO TO FULL VERSION