Modal

Un modal es un <dialog>. Cualquier botón con commandfor apuntando al id del modal y command: 'show-modal' lo abre en modo modal: la página de detrás queda inerte, así que el foco y el lector de pantalla se quedan dentro. Sin script por ningún lado: el fondo, Escape y el clic fuera son cosa del navegador.

Por eso el id es obligatorio y el componente lanza un error sin él: el id es todo el cableado.

Todos los modales de esta página se abren de verdad: pruébalos.

¿Recompilar el sitio?

Esto ejecuta sitelo build y vuelve a publicar dist/.
fragment(
  button({ commandfor: 'demo-basic', command: 'show-modal' }, 'Abrir modal'),
  modal({ id: 'demo-basic', title: '¿Recompilar el sitio?' },
    'Esto ejecuta sitelo build y vuelve a publicar dist/.',
  ),
)

Con pie

Un botón de cerrar es cualquier botón que apunte al mismo id con command: 'close'.

¿Eliminar esta página?

Esto no se puede deshacer. El HTML generado desaparece en la siguiente compilación.
fragment(
  button({ color: 'danger', commandfor: 'demo-confirm', command: 'show-modal' }, 'Eliminar página…'),
  modal({
    id: 'demo-confirm',
    title: '¿Eliminar esta página?',
    footer: stack({ direction: 'row', gap: 'sm' },
      button({
        variant: 'ghost',
        color: 'neutral',
        commandfor: 'demo-confirm',
        command: 'close',
      }, 'Cancelar'),
      button({ color: 'danger' }, 'Eliminar'),
    ),
  }, 'Esto no se puede deshacer. El HTML generado desaparece en la siguiente compilación.'),
)

Tamaños

Pequeño

size: sm — unas 24rem.

Mediano

El valor por defecto — unas 32rem.

Grande

size: lg — unas 48rem.
fragment(
  stack({ direction: 'row', gap: 'sm', wrap: true },
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-sm', command: 'show-modal' }, 'Pequeño'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-md', command: 'show-modal' }, 'Mediano'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-lg', command: 'show-modal' }, 'Grande'),
  ),
  modal({ id: 'demo-sm', size: 'sm', title: 'Pequeño' }, 'size: sm — unas 24rem.'),
  modal({ id: 'demo-md', title: 'Mediano' }, 'El valor por defecto — unas 32rem.'),
  modal({ id: 'demo-lg', size: 'lg', title: 'Grande' }, 'size: lg — unas 48rem.'),
)

Formularios dentro de un modal

Página nueva

fragment(
  button({ variant: 'soft', commandfor: 'demo-form', command: 'show-modal' }, 'Página nueva…'),
  modal({
    id: 'demo-form',
    title: 'Página nueva',
    footer: stack({ direction: 'row', gap: 'sm' },
      button({ variant: 'ghost', color: 'neutral', commandfor: 'demo-form', command: 'close' }, 'Cancelar'),
      button({ type: 'submit' }, 'Crear'),
    ),
  },
    stack({ gap: 'md' },
      textField({ label: 'Título', name: 'modal-title', placeholder: 'Acerca de' }),
      selectField({ label: 'Extensión', name: 'modal-ext', options: ['.ht.js', '.ht.ts', '.ht.jsx'] }),
    ),
  ),
)

Sin botón de cerrar

closable: false quita la × de la esquina. Escape y el clic fuera lo siguen cerrando; con closedby: 'closerequest' solo lo cierra Escape.

Pulsa Escape

O haz clic en cualquier sitio fuera de este diálogo.
fragment(
  button({ variant: 'outline', color: 'neutral', commandfor: 'demo-bare', command: 'show-modal' }, 'Sin botón de cerrar'),
  modal({ id: 'demo-bare', title: 'Pulsa Escape', closable: false },
    'O haz clic en cualquier sitio fuera de este diálogo.',
  ),
)

Contenido largo

El cuerpo se desplaza; la cabecera y el pie se quedan quietos.

Notas de la versión

Cambio 1 — se arregló algo.

Cambio 2 — se arregló algo.

Cambio 3 — se arregló algo.

Cambio 4 — se arregló algo.

Cambio 5 — se arregló algo.

Cambio 6 — se arregló algo.

Cambio 7 — se arregló algo.

Cambio 8 — se arregló algo.

Cambio 9 — se arregló algo.

Cambio 10 — se arregló algo.

Cambio 11 — se arregló algo.

Cambio 12 — se arregló algo.

fragment(
  button({ variant: 'outline', color: 'neutral', commandfor: 'demo-long', command: 'show-modal' }, 'Modal largo'),
  modal({
    id: 'demo-long',
    title: 'Notas de la versión',
    footer: button({ commandfor: 'demo-long', command: 'close' }, 'Cerrar'),
  },
    stack({ gap: 'md' },
      ...Array.from({ length: 12 }, (unused, index) =>
        text({ variant: 'small', tone: 'muted' }, 'Cambio ' + (index + 1) + ' — se arregló algo.'),
      ),
    ),
  ),
)

Desplazamiento del fondo

La página que hay detrás de un modal abierto no se desplaza. Eso es lo único que un diálogo modal te deja a ti, y aquí está hecho en CSS: sin script y sin nada que inicializar. Pasa lockScroll: false para dejar que el fondo se desplace como siempre.

Soporte de navegadores

Abrir un diálogo con el command de un botón funciona en todos los navegadores actuales: Chrome 135, Firefox 144 y Safari 26.2 en adelante. En uno anterior, button() añade un onclick que descarga unos cientos de bytes de /su/dialog.js para hacer lo mismo, solo allí y solo en el primer clic. Safari aún no cierra un diálogo al pulsar fuera (closedby), y ahí también se encarga ese mismo archivo.

Props

PropTipoPor defectoDescripción
idstring—Obligatorio. Aquello a lo que apunta el commandfor de un disparador.
titleChild—Encabezado, y nombre accesible del diálogo.
size'sm' | 'md' | 'lg''md'Ancho máximo.
footerChild—Fila inferior, sobre su propia banda teñida.
closablebooleantrueMostrar la × en la cabecera.
closeLabelstring'Close'Nombre accesible de ese botón.
lockScrollbooleantrueImpedir que la página de detrás se desplace mientras está abierto.

closeButton({ target }) dibuja esa × por su cuenta, para una cabecera que construyas tú.