CodeGym /Corsi /Frontend SELF IT /Elementi per la marcatura dei dialoghi

Elementi per la marcatura dei dialoghi

Frontend SELF IT
Livello 10, Lezione 4
Disponibile

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:

HTML
    
      <dialog>
        <!-- Contenuto della finestra di dialogo -->
      </dialog>
    
  
HTML
    
      <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>
    
  
HTML
    
      <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>
    
  
JavaScript
    
// 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:

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

JavaScript
    
dialog.close('confirm');
console.log(dialog.returnValue); // "confirm"
    
  

Metodo show():

Apre la finestra di dialogo in modalità non modale.

JavaScript
    
      dialog.show();
    
  

Metodo showModal():

Apre la finestra di dialogo in modalità modale, bloccando l’interazione con il resto della pagina.

JavaScript
    
      dialog.showModal();
    
  

Metodo close():

Chiude la finestra di dialogo.

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

HTML
    
<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, quindi getElementById restituirebbe null.
  • 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() chiama show().

4.3 Eventi di <dialog>

Evento close:

Evento che si verifica quando la finestra di dialogo viene chiusa.

HTML
    
      <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>
    
  
HTML
    
      <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>
    
  
JavaScript
    
// 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).

HTML
    
      <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>
    
  
HTML
    
      <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>
    
  
JavaScript
    
// 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');
});
    
  
1
Compito
Frontend SELF IT, livello 10, lezione 4
Bloccato
Finestra di dialogo semplice
Finestra di dialogo semplice
1
Compito
Frontend SELF IT, livello 10, lezione 4
Bloccato
Attributi
Attributi
Commenti
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION