Okno modalne

Okno modalne to element <dialog>. Dowolny przycisk z commandfor wskazującym id okna i command: 'show-modal' otwiera je modalnie: strona pod spodem staje się bezwładna (inert), więc fokus i czytnik ekranu zostają w oknie. Nigdzie nie ma skryptu — tłem, Escape i kliknięciem poza zajmuje się przeglądarka.

Dlatego id jest wymagane i dlatego komponent bez niego zgłasza błąd: identyfikator to całe okablowanie.

Podstawowe okno

Każde okno na tej stronie naprawdę się otwiera — spróbuj.

Przebudować witrynę?

To uruchamia sitelo build i publikuje dist/ od nowa.
fragment(
  button({ commandfor: 'demo-basic', command: 'show-modal' }, 'Otwórz okno'),
  modal({ id: 'demo-basic', title: 'Przebudować witrynę?' },
    'To uruchamia sitelo build i publikuje dist/ od nowa.',
  ),
)

Ze stopką

Przycisk zamykający to dowolny przycisk wskazujący na to samo id z command: 'close'.

Usunąć tę stronę?

Tego nie da się cofnąć. Wygenerowany HTML zniknie przy następnym buildzie.
fragment(
  button({ color: 'danger', commandfor: 'demo-confirm', command: 'show-modal' }, 'Usuń stronę…'),
  modal({
    id: 'demo-confirm',
    title: 'Usunąć tę stronę?',
    footer: stack({ direction: 'row', gap: 'sm' },
      button({
        variant: 'ghost',
        color: 'neutral',
        commandfor: 'demo-confirm',
        command: 'close',
      }, 'Anuluj'),
      button({ color: 'danger' }, 'Usuń'),
    ),
  }, 'Tego nie da się cofnąć. Wygenerowany HTML zniknie przy następnym buildzie.'),
)

Rozmiary

Małe

size: sm — około 24rem.

Średnie

Domyślne — około 32rem.

Duże

size: lg — około 48rem.
fragment(
  stack({ direction: 'row', gap: 'sm', wrap: true },
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-sm', command: 'show-modal' }, 'Małe'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-md', command: 'show-modal' }, 'Średnie'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-lg', command: 'show-modal' }, 'Duże'),
  ),
  modal({ id: 'demo-sm', size: 'sm', title: 'Małe' }, 'size: sm — około 24rem.'),
  modal({ id: 'demo-md', title: 'Średnie' }, 'Domyślne — około 32rem.'),
  modal({ id: 'demo-lg', size: 'lg', title: 'Duże' }, 'size: lg — około 48rem.'),
)

Formularze w oknie

Nowa strona

fragment(
  button({ variant: 'soft', commandfor: 'demo-form', command: 'show-modal' }, 'Nowa strona…'),
  modal({
    id: 'demo-form',
    title: 'Nowa strona',
    footer: stack({ direction: 'row', gap: 'sm' },
      button({ variant: 'ghost', color: 'neutral', commandfor: 'demo-form', command: 'close' }, 'Anuluj'),
      button({ type: 'submit' }, 'Utwórz'),
    ),
  },
    stack({ gap: 'md' },
      textField({ label: 'Tytuł', name: 'modal-title', placeholder: 'O projekcie' }),
      selectField({ label: 'Rozszerzenie', name: 'modal-ext', options: ['.ht.js', '.ht.ts', '.ht.jsx'] }),
    ),
  ),
)

Bez przycisku zamykania

closable: false usuwa × z rogu. Escape i kliknięcie poza nadal je zamykają; z closedby: 'closerequest' zamyka je już tylko Escape.

Naciśnij Escape

Albo kliknij gdziekolwiek poza tym oknem.
fragment(
  button({ variant: 'outline', color: 'neutral', commandfor: 'demo-bare', command: 'show-modal' }, 'Bez przycisku zamykania'),
  modal({ id: 'demo-bare', title: 'Naciśnij Escape', closable: false },
    'Albo kliknij gdziekolwiek poza tym oknem.',
  ),
)

Długa treść

Treść się przewija; nagłówek i stopka zostają na miejscu.

Informacje o wydaniu

Zmiana 1 — coś naprawiono.

Zmiana 2 — coś naprawiono.

Zmiana 3 — coś naprawiono.

Zmiana 4 — coś naprawiono.

Zmiana 5 — coś naprawiono.

Zmiana 6 — coś naprawiono.

Zmiana 7 — coś naprawiono.

Zmiana 8 — coś naprawiono.

Zmiana 9 — coś naprawiono.

Zmiana 10 — coś naprawiono.

Zmiana 11 — coś naprawiono.

Zmiana 12 — coś naprawiono.

fragment(
  button({ variant: 'outline', color: 'neutral', commandfor: 'demo-long', command: 'show-modal' }, 'Długie okno'),
  modal({
    id: 'demo-long',
    title: 'Informacje o wydaniu',
    footer: button({ commandfor: 'demo-long', command: 'close' }, 'Zamknij'),
  },
    stack({ gap: 'md' },
      ...Array.from({ length: 12 }, (unused, index) =>
        text({ variant: 'small', tone: 'muted' }, 'Zmiana ' + (index + 1) + ' — coś naprawiono.'),
      ),
    ),
  ),
)

Przewijanie tła

Strona za otwartym oknem się nie przewija. To jedyna rzecz, którą modalne okno dialogowe zostawia Tobie, a tutaj zrobiona jest w CSS-ie — bez skryptu i bez niczego do zainicjowania. Podaj lockScroll: false, żeby tło przewijało się jak zwykle.

Wsparcie przeglądarek

Otwieranie okna dialogowego przez command przycisku działa w każdej aktualnej przeglądarce — Chrome 135, Firefox 144 i Safari 26.2 lub nowszych. W starszej button() dodaje onclick, który pobiera kilkaset bajtów /su/dialog.js i robi to samo — tylko tam i dopiero przy pierwszym kliknięciu. Safari nie zamyka jeszcze okna kliknięciem poza (closedby); tam również zajmuje się tym ten sam plik.

Propsy

PropTypDomyślnieOpis
idstring—Wymagane. To, na co wskazuje commandfor wyzwalacza.
titleChild—Nagłówek i dostępna nazwa okna dialogowego.
size'sm' | 'md' | 'lg''md'Maksymalna szerokość.
footerChild—Dolny rząd, na własnym zabarwionym pasie.
closablebooleantruePokaż × w nagłówku.
closeLabelstring'Close'Dostępna nazwa tego przycisku.
lockScrollbooleantrueBlokuje przewijanie strony za nim, gdy jest otwarte.

closeButton({ target }) renderuje samo × — dla nagłówka, który budujesz ręcznie.