Modal

Ein Modal ist ein <dialog>-Element. Jeder Button mit commandfor auf die id des Modals und command: 'show-modal' öffnet es modal: Die Seite dahinter wird inert, Fokus und Screenreader bleiben also im Dialog. Nirgends ein Skript — Hintergrund, Escape und Klick nach außen gehören alle dem Browser.

Deshalb ist die id Pflicht, und deshalb wirft die Komponente ohne sie: die id ist die ganze Verkabelung.

Einfaches Modal

Jedes Modal auf dieser Seite geht wirklich auf — probier es aus.

Website neu bauen?

Das führt sitelo build aus und veröffentlicht dist/ erneut.
fragment(
  button({ commandfor: 'demo-basic', command: 'show-modal' }, 'Modal öffnen'),
  modal({ id: 'demo-basic', title: 'Website neu bauen?' },
    'Das führt sitelo build aus und veröffentlicht dist/ erneut.',
  ),
)

Ein Schließen-Button ist jeder Button, der mit command: 'close' auf dieselbe id zeigt.

Diese Seite löschen?

Das lässt sich nicht rückgängig machen. Das erzeugte HTML verschwindet beim nächsten Build.
fragment(
  button({ color: 'danger', commandfor: 'demo-confirm', command: 'show-modal' }, 'Seite löschen…'),
  modal({
    id: 'demo-confirm',
    title: 'Diese Seite löschen?',
    footer: stack({ direction: 'row', gap: 'sm' },
      button({
        variant: 'ghost',
        color: 'neutral',
        commandfor: 'demo-confirm',
        command: 'close',
      }, 'Abbrechen'),
      button({ color: 'danger' }, 'Löschen'),
    ),
  }, 'Das lässt sich nicht rückgängig machen. Das erzeugte HTML verschwindet beim nächsten Build.'),
)

Größen

Klein

size: sm — etwa 24rem.

Mittel

Der Standard — etwa 32rem.

Groß

size: lg — etwa 48rem.
fragment(
  stack({ direction: 'row', gap: 'sm', wrap: true },
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-sm', command: 'show-modal' }, 'Klein'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-md', command: 'show-modal' }, 'Mittel'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-lg', command: 'show-modal' }, 'Groß'),
  ),
  modal({ id: 'demo-sm', size: 'sm', title: 'Klein' }, 'size: sm — etwa 24rem.'),
  modal({ id: 'demo-md', title: 'Mittel' }, 'Der Standard — etwa 32rem.'),
  modal({ id: 'demo-lg', size: 'lg', title: 'Groß' }, 'size: lg — etwa 48rem.'),
)

Formulare in einem Modal

Neue Seite

fragment(
  button({ variant: 'soft', commandfor: 'demo-form', command: 'show-modal' }, 'Neue Seite…'),
  modal({
    id: 'demo-form',
    title: 'Neue Seite',
    footer: stack({ direction: 'row', gap: 'sm' },
      button({ variant: 'ghost', color: 'neutral', commandfor: 'demo-form', command: 'close' }, 'Abbrechen'),
      button({ type: 'submit' }, 'Anlegen'),
    ),
  },
    stack({ gap: 'md' },
      textField({ label: 'Titel', name: 'modal-title', placeholder: 'Über' }),
      selectField({ label: 'Endung', name: 'modal-ext', options: ['.ht.js', '.ht.ts', '.ht.jsx'] }),
    ),
  ),
)

Ohne Schließen-Button

closable: false lässt das × in der Ecke weg. Escape und ein Klick nach außen schließen es weiterhin; mit closedby: 'closerequest' schließt nur noch Escape.

Drück Escape

Oder klick irgendwo außerhalb dieses Dialogs.
fragment(
  button({ variant: 'outline', color: 'neutral', commandfor: 'demo-bare', command: 'show-modal' }, 'Ohne Schließen-Button'),
  modal({ id: 'demo-bare', title: 'Drück Escape', closable: false },
    'Oder klick irgendwo außerhalb dieses Dialogs.',
  ),
)

Langer Inhalt

Der Körper scrollt; Kopf und Fuß bleiben stehen.

Release Notes

Änderung 1 — etwas wurde behoben.

Änderung 2 — etwas wurde behoben.

Änderung 3 — etwas wurde behoben.

Änderung 4 — etwas wurde behoben.

Änderung 5 — etwas wurde behoben.

Änderung 6 — etwas wurde behoben.

Änderung 7 — etwas wurde behoben.

Änderung 8 — etwas wurde behoben.

Änderung 9 — etwas wurde behoben.

Änderung 10 — etwas wurde behoben.

Änderung 11 — etwas wurde behoben.

Änderung 12 — etwas wurde behoben.

fragment(
  button({ variant: 'outline', color: 'neutral', commandfor: 'demo-long', command: 'show-modal' }, 'Langes Modal'),
  modal({
    id: 'demo-long',
    title: 'Release Notes',
    footer: button({ commandfor: 'demo-long', command: 'close' }, 'Schließen'),
  },
    stack({ gap: 'md' },
      ...Array.from({ length: 12 }, (unused, index) =>
        text({ variant: 'small', tone: 'muted' }, 'Änderung ' + (index + 1) + ' — etwas wurde behoben.'),
      ),
    ),
  ),
)

Scrollen im Hintergrund

Die Seite hinter einem offenen Modal scrollt nicht. Das ist das Einzige, was ein modaler Dialog dir überlässt, und es passiert hier in CSS — kein Skript, nichts zu initialisieren. Übergib lockScroll: false, damit der Hintergrund wie gewohnt scrollt.

Browser-Unterstützung

Einen Dialog per command eines Buttons zu öffnen, kann jeder aktuelle Browser — Chrome ab 135, Firefox ab 144, Safari ab 26.2. In einem älteren hängt button() ein onclick an, das ein paar hundert Bytes /su/dialog.js lädt und dasselbe tut — nur dort und erst beim ersten Klick. Schließen bei Klick nach außen (closedby) kann Safari noch nicht; das übernimmt dort dieselbe Datei.

Props

PropTypStandardBeschreibung
idstring—Pflicht. Worauf das commandfor eines Auslösers zeigt.
titleChild—Überschrift und zugänglicher Name des Dialogs.
size'sm' | 'md' | 'lg''md'Maximale Breite.
footerChild—Untere Reihe, auf einem eigenen getönten Band.
closablebooleantrueDas × in der Kopfzeile zeigen.
closeLabelstring'Close'Zugänglicher Name dieses Buttons.
lockScrollbooleantrueDie Seite dahinter am Scrollen hindern, solange es offen ist.

closeButton({ target }) rendert dieses × für sich, für eine Kopfzeile, die du selbst baust.