CodeGym /Cursos /Frontend SELF ES /Elementos para la maquetación de diálogos

Elementos para la maquetación de diálogos

Frontend SELF ES
Nivel 10, Lección 4
Disponible

4.1 Elemento <dialog>

En HTML5 también apareció el elemento <dialog>, pensado para crear cuadros de diálogo y ventanas modales en las páginas web. Este elemento permite crear ventanas emergentes de forma sencilla y semánticamente correcta para distintos fines: notificaciones, confirmaciones, formularios de entrada y mucho más. A continuación veremos cómo usar <dialog>, sus atributos y métodos, además de algunos ejemplos de uso.

El elemento <dialog> representa un cuadro de diálogo u otra ventana interactiva. Puede ser modal o no modal. Dentro del elemento <dialog> puedes colocar cualquier contenido HTML: texto, formularios, botones, etc.

Sintaxis:

HTML
    
      <dialog>
        <!-- Contenido del cuadro de diálogo -->
      </dialog>
    
  
HTML
    
      <div style="min-height: 200px;">
        <dialog id="favSuperHeroDialog">
          <form method="dialog">
            <div>
              <label for="favSuperHero">Superhéroe favorito:</label>
              <select id="favSuperHero" name="favSuperHero">
                <option></option>
                <option>Capitán América</option>
                <option>Iron Man</option>
                <option>Hulk</option>
              </select>
            </div>
            <div>
              <button type="reset" id="cancel">Restablecer</button>
              <button type="submit">Confirmar</button>
            </div>
          </form>
        </dialog>
        <button id="updateDetails">Abrir cuadro de diálogo</button>
      </div>
    
  
HTML
    
      <dialog id="favSuperHeroDialog">
        <form method="dialog">
          <div>
            <label for="favSuperHero">Superhéroe favorito:</label>
            <select id="favSuperHero" name="favSuperHero">
              <option></option>
              <option>Capitán América</option>
              <option>Iron Man</option>
              <option>Hulk</option>
            </select>
          </div>
          <div>
            <button type="reset" id="cancel">Restablecer</button>
            <button type="submit">Confirmar</button>
          </div>
        </form>
      </dialog>
      <button id="updateDetails">Abrir cuadro de diálogo</button>
    
  
JavaScript
    
// Obtenemos los botones y el diálogo del DOM
const updateButton = document.getElementById("updateDetails");
const cancelButton = document.getElementById("cancel");
const dialog = document.getElementById("favSuperHeroDialog");

// Función que comprueba el estado del diálogo (abierto/cerrado)
function openCheck(dialog) {
 if (dialog.open) {
   console.log("Diálogo iniciado");
 } else {
   console.log("Diálogo terminado");
 }
}

// Abrimos el diálogo al hacer clic en el botón Update
updateButton.addEventListener("click", () => {
 dialog.showModal();
 openCheck(dialog);
});

// Cerramos el diálogo al hacer clic en el botón Cancel
cancelButton.addEventListener("click", () => {
 dialog.close();
 openCheck(dialog);
});
    
  

4.2 Atributos y métodos de <dialog>

El atributo open indica si el cuadro de diálogo está abierto. Si este atributo está presente, el diálogo se muestra en la página.

Ejemplo de uso del atributo open:

HTML
    
      <dialog open>
        <p>Este es un cuadro de diálogo abierto.</p>
      </dialog>
    
  

Una ventana mostrada con el atributo open siempre es no modal. La ventana modal se abre con el método showModal() (lo vemos más abajo).

La propiedad returnValue guarda una cadena con el resultado: el valor con el que se cerró la ventana. Es una propiedad del objeto JavaScript del diálogo, no un atributo HTML, así que no se escribe en el marcado. El valor lo fija el método close('valor') o un botón de un formulario con method="dialog"; en ese caso, en returnValue va el value del botón pulsado. Si la ventana se cerró con la tecla Esc, returnValue no cambia.

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

Método show():

Abre el cuadro de diálogo en modo no modal.

JavaScript
    
      dialog.show();
    
  

Método showModal():

Abre el cuadro de diálogo en modo modal y bloquea la interacción con el resto de la página.

JavaScript
    
      dialog.showModal();
    
  

Método close():

Cierra el cuadro de diálogo.

JavaScript
    
      dialog.close();
    
  

Cómo «vincular» un método a un botón: lo mínimo de JavaScript

El atributo open muestra la ventana nada más cargar la página. Para que la ventana se abra y se cierre con un botón, en esta lección llamamos a los métodos show(), showModal() y close() desde JavaScript: son justo los que necesitas en las tareas. El lenguaje lo veremos a fondo más adelante; por ahora basta con esta plantilla:

HTML
    
<button id="btn-open">Mostrar pista</button>
<dialog id="info-dialog">
  <p>Texto de la ventana</p>
  <button id="btn-close">Entendido</button>
</dialog>

<script>
  // 1. Buscamos los elementos de la página por su id
  const openBtn = document.getElementById('btn-open');
  const closeBtn = document.getElementById('btn-close');
  const infoDialog = document.getElementById('info-dialog');

  // 2. «Cuando hagan clic en el botón, ejecuta el código entre llaves»
  openBtn.addEventListener('click', () => {
    infoDialog.showModal();   // abrir en modo modal
  });

  closeBtn.addEventListener('click', () => {
    infoDialog.close();       // cerrar
  });
</script>
    
  
  • <script> lo ponemos al final de <body>: el navegador ejecuta el script en cuanto llega a él, y los elementos que están debajo del script todavía no existen, así que getElementById devolvería null.
  • document.getElementById('…') significa «dame el elemento con este id».
  • elemento.addEventListener('click', () => { … }) significa «cuando hagan clic en el elemento, ejecuta el código entre llaves». La expresión () => { … } es una función corta: código que se ejecutará más tarde, al hacer clic.
  • Para una ventana no modal, en lugar de showModal() llama a show().

4.3 Eventos de <dialog>

Evento close:

Evento que se produce al cerrar el cuadro de diálogo.

HTML
    
      <div style="min-height: 200px">
        <dialog id="myDialog">
          <form method="dialog">
            <p>Pulsa el botón "Cancelar" o "OK" para devolver un valor</p>
            <div class="dialog-buttons">
              <button value="cancel">Cancelar</button>
              <button value="confirm">OK</button>
            </div>
          </form>
        </dialog>
        <button id="showDialog">Mostrar cuadro de diálogo</button>
      </div>
    
  
HTML
    
      <dialog id="myDialog">
        <form method="dialog">
          <p>Pulsa el botón "Cancelar" o "OK" para devolver un valor</p>
          <div class="dialog-buttons">
            <button value="cancel">Cancelar</button>
            <button value="confirm">OK</button>
          </div>
        </form>
      </dialog>
      <button id="showDialog">Mostrar cuadro de diálogo</button>
    
  
JavaScript
    
// Obtenemos los elementos del DOM
const dialog = document.getElementById('myDialog');
const showDialogButton = document.getElementById('showDialog');

// Apertura de la ventana modal
showDialogButton.addEventListener('click', () => {
 dialog.showModal();
});

// Al cerrar, mostramos returnValue
dialog.addEventListener('close', () => {
 alert(`Diálogo cerrado con el valor devuelto: ${dialog.returnValue}`);
});
    
  

Evento cancel:

Evento que se produce al cancelar el cuadro de diálogo (por ejemplo, al pulsar la tecla Esc).

HTML
    
      <div style="min-height: 200px">
        <dialog id="myDialog">
          <form method="dialog">
            <p>Pulsa la tecla "Esc" para ver el resultado</p>
          </form>
        </dialog>
        <button id="showDialog">Abrir cuadro de diálogo</button>
      </div>
    
  
HTML
    
      <dialog id="myDialog">
        <form method="dialog">
          <p>Pulsa la tecla "Esc" para ver el resultado</p>
        </form>
      </dialog>
      <button id="showDialog">Abrir cuadro de diálogo</button>
    
  
JavaScript
    
// Obtenemos los elementos del DOM
const dialog = document.getElementById('myDialog');
const showDialogButton = document.getElementById('showDialog');

// Apertura del diálogo
showDialogButton.addEventListener("click", () => {
 dialog.showModal();
});

// Gestión de la cancelación del diálogo (tecla Esc)
dialog.addEventListener('cancel', () => {
 alert('Dialog was cancelled');
});
    
  
1
Tarea
Frontend SELF ES, nivel 10, lección 4
Bloqueada
Ventana de diálogo simple
Ventana de diálogo simple
1
Tarea
Frontend SELF ES, nivel 10, lección 4
Bloqueada
Atributos
Atributos
Comentarios
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION