Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

dialog — un cuadro de diálogo nativo

El elemento `dialog` representa una ventana temporal para realizar una tarea o presentar información. Su método `show()` la muestra de forma no modal, mientras que `showModal()` bloquea la interacción con el resto del documento.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<dialog>…</dialog>
dialog.show();
dialog.showModal();
dialog.close(result);

dialog es una ventana para una interacción breve con la aplicación, no un sustituto de un menú o una descripción emergente. Se necesitan las etiquetas de apertura y cierre. Sin open, no se muestra de forma predeterminada; open por sí solo no crea un cuadro de diálogo modal.

show() muestra un cuadro de diálogo no modal. showModal() lo coloca en la capa superior; el resto del documento queda inactivo (inert). El elemento debe estar conectado al documento. Si se llama a showModal() en un cuadro de diálogo ya abierto de forma no modal, se produce InvalidStateError.

Proporciona un nombre significativo, por ejemplo mediante aria-labelledby, y un botón de cierre visible. Elige el foco inicial con autofocus en un control adecuado. No establezcas tabindex en dialog.

close(result) cierra el cuadro de diálogo, guarda la cadena proporcionada en returnValue y provoca un evento close. requestClose(result) primero desencadena el evento cancelable cancel; preventDefault() puede impedir el cierre. No elimines open manualmente, porque así se omite el ciclo de cierre adecuado. closedby controla el cierre automático: any permite también los clics fuera del cuadro, closerequest permite las solicitudes de cierre y none no permite ninguna de las dos cosas. Sin este atributo, los cuadros modales gestionan las solicitudes de cierre y los no modales no.

Ejemplos

<!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>

Resultado

Result: confirmed

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes