Ejemplos

Formulario en modal

Patrón CTA: botón de acción → modal con cabecera (título y cerrar), cuerpo con scroll y pie (Cancelar ghost + acción primaria). Se abre sin JS con command="show-modal".

Vista previa · colores por defecto de angela

Nuevo cliente

Escribe el nombre del cliente.

Escribe un correo válido.

<button class="button" type="button" commandfor="d-cliente" command="show-modal"><svg aria-hidden="true">…</svg> Nuevo cliente</button>

<dialog class="dialog" id="d-cliente" aria-labelledby="d-cliente-titulo" closedby="any">
  <header class="dialog-header">
    <h2 id="d-cliente-titulo">Nuevo cliente</h2>
    <button class="button" type="button" data-variant="ghost" data-tone="neutral" data-icon-only
      commandfor="d-cliente" command="close" aria-label="Cerrar"><svg aria-hidden="true">…</svg></button>
  </header>
  <div class="dialog-body">
    <form id="d-cliente-form" class="stack" method="dialog">
      <div class="field">
        <label for="d-nombre">Nombre</label>
        <input class="input" id="d-nombre" name="nombre" required autocomplete="name" autofocus data-error="d-nombre-error">
        <p class="error" id="d-nombre-error">Escribe el nombre del cliente.</p>
      </div>
      <div class="field">
        <label for="d-email">Correo</label>
        <input class="input" id="d-email" name="email" type="email" autocomplete="email" data-error="d-email-error">
        <p class="error" id="d-email-error">Escribe un correo válido.</p>
      </div>
    </form>
  </div>
  <footer class="dialog-footer">
    <button class="button" type="button" data-variant="ghost" data-tone="neutral" commandfor="d-cliente" command="close">Cancelar</button>
    <button class="button" type="submit" form="d-cliente-form" value="guardar">Guardar cliente</button>
  </footer>
</dialog>

Confirmar una eliminación

Toda eliminación pide confirmación. El foco inicial va a la opción segura (Cancelar). El diálogo devuelve el botón pulsado en dialog.returnValue.

Vista previa · colores por defecto de angela

¿Eliminar el proyecto?

Se borrarán sus 12 tareas. Esta acción no se puede deshacer.

<button class="button" type="button" data-variant="outline" data-tone="danger" commandfor="d-borrar" command="show-modal"><svg aria-hidden="true">…</svg> Eliminar proyecto</button>

<dialog class="dialog" id="d-borrar" data-size="sm" aria-labelledby="d-borrar-titulo" aria-describedby="d-borrar-desc">
  <div class="dialog-body stack" style="--stack-gap: var(--space-2)">
    <h2 id="d-borrar-titulo" style="font-size: var(--fs-lg); margin: 0">¿Eliminar el proyecto?</h2>
    <p id="d-borrar-desc" class="muted">Se borrarán sus 12 tareas. Esta acción no se puede deshacer.</p>
  </div>
  <form class="dialog-footer" method="dialog">
    <button class="button" value="cancelar" data-variant="ghost" data-tone="neutral" autofocus>Cancelar</button>
    <button class="button" value="eliminar" data-tone="danger">Eliminar</button>
  </form>
</dialog>

API

Clases y atributos de Diálogo
Clase o atributoUso
.dialogEn <dialog>. data-size="sm|lg" (32rem por defecto).
.dialog-header / -body / -footerCabecera, cuerpo con scroll y pie de acciones.
.dialog-formUn <form> que envuelve cabecera, cuerpo y pie, para que el botón de enviar del pie quede dentro del formulario.
command="show-modal"En el botón que abre, junto con commandfor="id-del-diálogo".
command="close"Cierra el diálogo. Fuera de un <form>, o con type="button".
closedby="any"Permite cerrar con clic fuera (@angela-ui/angela/js lo completa en Safari).

Accesibilidad

  • El navegador vuelve inerte la página, contiene el foco, cierra con Esc y devuelve el foco al botón que lo abrió. No añadas role="dialog", aria-modal ni trampas de foco.
  • Nombra el diálogo con aria-labelledby apuntando a su título.
  • Pon autofocus en el primer campo, o en la opción segura si la acción es destructiva.
  • El fondo no se desplaza mientras el modal está abierto (overscroll-behavior, sin overflow:hidden en <body>).
  • Animación corta; con movimiento reducido solo se desvanece.