Una finestra di dialogo modale è un tipo speciale di finestra popup che interrompe l'utente su una pagina web. Sebbene esistano alcuni casi d'uso validi per la visualizzazione di una finestra di dialogo, dovresti valutare attentamente prima di aggiungerne una. Le finestre di dialogo modali costringono gli utenti a concentrarsi su contenuti specifici e a ignorare temporaneamente il resto della pagina.
Le finestre di dialogo possono essere:
- Modale: gli utenti possono interagire solo con i contenuti all'interno della finestra di dialogo. Le finestre di dialogo modali vengono visualizzate sopra i contenuti della pagina. La pagina è impostata su inert e, per impostazione predefinita, è oscurata da uno sfondo semitrasparente.
- Non modale: gli utenti possono interagire con i contenuti al di fuori della finestra di dialogo.
L'elemento HTML semantico <dialog> per creare una finestra di dialogo include semantica, interazioni con la tastiera e tutte le proprietà e i metodi dell'interfaccia HTMLDialogElement.
Finestre di dialogo modali
Ecco un esempio di finestra modale <dialog>. Fai clic su Apri finestra di dialogo modale.
Una volta aperta, la finestra di dialogo può essere chiusa in tre modi: con il tasto Esc, inviando un modulo con un pulsante con l'attributo formmethod="dialog" impostato (o se il modulo stesso ha l'attributo method="dialog" impostato) e con il metodo HTMLDialogElement.close().
HTMLDialogElement ha tre metodi principali, oltre a tutti i metodi ereditati da HTMLElement.
dialog.show() /* opens the dialog */
dialog.showModal() /* opens the dialog as a modal */
dialog.close() /* closes the dialog */
Poiché questo <dialog> è stato aperto con il metodo HTMLDialogElement.showModal(), si tratta di una finestra di dialogo modale. L'apertura di una finestra di dialogo modale disattiva e oscura tutto ciò che non è la finestra di dialogo stessa. Quando passi il mouse sopra la UI al di fuori della finestra di dialogo, tutti gli elementi si comportano come se fosse impostato pointer-events: none;. Anche il pulsante che apre la finestra di dialogo non reagirà alle interazioni.
Quando la finestra di dialogo viene aperta, lo stato attivo si sposta al suo interno. Lo stato attivo viene impostato sul primo elemento nell'ordine di navigazione sequenziale da tastiera all'interno della finestra di dialogo.
Se premi ripetutamente il tasto tab, solo i contenuti all'interno della finestra di dialogo possono ricevere lo stato attivo mentre la finestra modale è aperta. Tutto ciò che si trova all'esterno della finestra modale rimane inerte.
Quando una finestra di dialogo viene chiusa, modale o meno, lo stato attivo torna all'elemento che l'ha aperta. Evita di aprire una finestra di dialogo in modo programmatico senza un'azione dell'utente. Se devi farlo, assicurati di riportare lo stato attivo alla posizione precedente all'apertura della finestra di dialogo, soprattutto se l'utente la chiude senza interagirvi.
Esiste un attributo inert globale che può essere utilizzato per disattivare un elemento e tutti i suoi discendenti, ad eccezione di qualsiasi finestra di dialogo attiva. Quando una finestra di dialogo modale viene aperta utilizzando showModal(), l'inerzia o la disattivazione avviene per impostazione predefinita. L'attributo non è impostato esplicitamente.
Lo sfondo che oscura tutto tranne la finestra di dialogo può essere personalizzato utilizzando lo pseudo-elemento ::backdrop. Lo sfondo viene visualizzato solo quando viene mostrato un <dialog> con il metodo .showModal(). Questo pseudo-elemento corrisponde a tutti gli sfondi, incluso quello visualizzato quando viene utilizzata l'API FullScreen, ad esempio quando si visualizza un video in modalità a schermo intero che non ha le stesse proporzioni dello schermo o del monitor.
Finestre di dialogo non modali
L'elemento HTMLDialogElement.show() apre una finestra di dialogo in modo simile, ma senza aggiungere uno sfondo o rendere inerte un elemento. Il tasto Esc chiude solo le finestre di dialogo modali, non quelle non modali. Per questo motivo, è ancora più importante includere un metodo per chiudere la finestra di dialogo non modale. Se l'opzione di chiusura si trova all'esterno della finestra di dialogo, lo stato attivo tornerà all'elemento che ha aperto la finestra di dialogo. Questa
non è un'esperienza utente ideale.
Sebbene un pulsante per chiudere la finestra di dialogo non sia ufficialmente richiesto dalla specifica, consideralo obbligatorio. Un pulsante visibile che può ricevere lo stato attivo migliora l'accessibilità e l'esperienza utente.
Chiusura di una finestra di dialogo
Non è necessario il metodo HTMLDialogElement.close() per chiudere una finestra di dialogo. Non hai bisogno di JavaScript. Per chiudere <dialog> senza JavaScript, includi un modulo con un metodo dialog impostando method="dialog" su <form> o formmethod="dialog" sul pulsante.
Quando un utente invia un modulo con il metodo dialog, lo stato dei dati inseriti dall'utente viene mantenuto. Durante un evento di invio, il modulo viene sottoposto alla convalida dei vincoli (a meno che non sia impostato novalidate). I dati utente non vengono cancellati o inviati. Puoi creare un pulsante di chiusura senza JavaScript:
<dialog open>
<form method="dialog">
<button type="submit" autofocus>close</button>
</form>
</dialog>
In questo esempio, potresti aver notato l'attributo autofocus impostato sul tag di chiusura <button>. Gli elementi con l'attributo autofocus impostato all'interno di un <dialog> ricevono lo stato attivo al caricamento pagina solo se la pagina è già stata caricata con la finestra di dialogo visibile. Se la pagina non è stata caricata, questi elementi ricevono lo stato attivo quando viene aperta la finestra di dialogo.
Quando viene aperta una finestra di dialogo, il primo elemento attivabile al suo interno riceve lo stato attivo, a meno che non sia impostato l'attributo autofocus per un elemento diverso. L'impostazione dell'attributo autofocus sul pulsante di chiusura garantisce che riceva lo stato attivo quando la finestra di dialogo viene aperta. Tuttavia, l'inclusione di autofocus all'interno di un <dialog> deve essere eseguita solo dopo un'attenta valutazione. Tutti gli elementi della sequenza che precedono l'elemento con messa a fuoco automatica vengono ignorati.
Parliamo di questo attributo in modo più approfondito nel modulo di approfondimento.
L'interfaccia HTMLDialogElement include una proprietà returnValue. L'invio di un modulo con un method="dialog" imposta returnValue sul name, se presente, del pulsante di invio utilizzato per inviare il modulo. Se scrivessimo <button type="submit" name="toasty">close</button>, il returnValue sarebbe toasty.
Quando viene aperta una finestra di dialogo, è presente l'attributo booleano open, il che significa che la finestra di dialogo è attiva e può essere utilizzata.
Quando una finestra di dialogo viene aperta aggiungendo l'attributo open anziché con .show() o .showModal(), la finestra di dialogo non è modale. La proprietà HTMLDialogElement.open restituisce true o false, a seconda che la finestra di dialogo sia disponibile per l'interazione, non se è modale o meno.
Sebbene JavaScript sia il metodo preferito per aprire una finestra di dialogo, l'inclusione dell'attributo open al caricamento della pagina e la sua successiva rimozione con .close() possono contribuire a garantire che la finestra di dialogo sia disponibile anche quando JavaScript non lo è.
Ulteriori dettagli
Non utilizzare tabindex
L'elemento attivato per aprire la finestra di dialogo e il pulsante di chiusura al suo interno (ed eventualmente altri contenuti) possono ricevere lo stato attivo e sono interattivi. L'elemento <dialog> non è interattivo e non riceve lo stato attivo. Non aggiungere la proprietà tabindex alla finestra di dialogo stessa.
Ruoli ARIA
Il ruolo implicito è dialog.
Se la finestra di dialogo è una finestra di conferma che comunica un messaggio che richiede una risposta o una conferma dell'utente, imposta role="alertdialog".
Includi un nome accessibile per la finestra di dialogo. Se il testo visibile può fornire il nome accessibile, aggiungi aria-labelledby="idOfLabelingText".
Impostazioni predefinite CSS
I browser forniscono uno stile predefinito per dialog. Firefox, Chrome ed Edge impostano color: CanvasText; e background-color: Canvas;. Safari imposta
color: black; background-color: white; nei fogli di stile dello user agent.
color viene ereditato da dialog, anziché da body o :root, il che potrebbe essere inaspettato. La proprietà background-color non viene ereditata.
Mettiti alla prova
Metti alla prova le tue conoscenze sull'elemento dialog.
Come si applica lo stile all'area dietro la finestra di dialogo?
::background.::backdrop.background.