CKTIS / HTML
dialog — una finestra di dialogo nativa
L’elemento `dialog` rappresenta una finestra temporanea in cui completare un’attività o presentare informazioni. Il metodo `show()` la visualizza in modalità non modale, mentre `showModal()` blocca l’interazione con il resto del documento.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<dialog>…</dialog>
dialog.show();
dialog.showModal();
dialog.close(result);dialog è una finestra per una breve interazione con l’applicazione, non un sostituto di un menu o di un suggerimento. Sono necessari sia il tag di apertura sia quello di chiusura. Senza open, non viene mostrato per impostazione predefinita; open da solo non rende modale la finestra di dialogo.
show() visualizza una finestra di dialogo non modale. showModal() la colloca nel livello superiore; il resto del documento diventa inattivo (inert). L’elemento deve essere collegato al documento. Chiamare showModal() su una finestra di dialogo già aperta in modalità non modale genera InvalidStateError.
Fornisci un nome significativo, ad esempio tramite aria-labelledby, e un pulsante di chiusura visibile. Scegli il focus iniziale usando autofocus su un controllo adatto. Non impostare tabindex su dialog.
close(result) chiude la finestra di dialogo, memorizza la stringa fornita in returnValue e genera un evento close. requestClose(result) attiva prima l’evento annullabile cancel; preventDefault() può impedire la chiusura. Non rimuovere manualmente open, perché così si evita il corretto ciclo di chiusura. closedby controlla la chiusura automatica: any consente anche i clic all’esterno, closerequest consente le richieste di chiusura e none non consente né l’una né l’altra. Senza questo attributo, le finestre modali gestiscono le richieste di chiusura, mentre quelle non modali no.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Dialog example</title>
<button id="launch" type="button">Open</button>
<dialog id="box" aria-labelledby="heading">
<h2 id="heading">Confirmation</h2>
<p>Close this dialog to continue.</p>
<button id="finish" type="button" autofocus>OK</button>
</dialog>
<p id="status" role="status">Ready</p>
<script>
const box = document.getElementById('box');
const status = document.getElementById('status');
document.getElementById('launch').addEventListener('click', () => {
box.returnValue = '';
box.showModal();
});
document.getElementById('finish').addEventListener('click', () => {
box.close('confirmed');
});
box.addEventListener('close', () => {
status.textContent = box.returnValue === 'confirmed'
? 'Result: confirmed'
: 'Result: dismissed';
});
</script>
</html>Risultato
Result: confirmed
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.