Модальное окно

Модальное окно — это <dialog>. Любая кнопка с commandfor, указывающим на id окна, и command: 'show-modal' открывает его модально: страница позади становится инертной, так что фокус и экранный диктор остаются внутри. И нигде никакого скрипта — затемнением, Escape и кликом снаружи владеет браузер.

Поэтому id обязателен, и поэтому без него компонент бросает ошибку: id — это и есть вся проводка.

Простое окно

Каждое модальное окно на этой странице по-настоящему открывается — попробуйте.

Пересобрать сайт?

Это запустит sitelo build и заново опубликует dist/.
fragment(
  button({ commandfor: 'demo-basic', command: 'show-modal' }, 'Открыть окно'),
  modal({ id: 'demo-basic', title: 'Пересобрать сайт?' },
    'Это запустит sitelo build и заново опубликует dist/.',
  ),
)

С подвалом

Кнопка закрытия — это любая кнопка, указывающая на тот же id с command: 'close'.

Удалить эту страницу?

Это не отменить. Сгенерированный HTML исчезнет при следующей сборке.
fragment(
  button({ color: 'danger', commandfor: 'demo-confirm', command: 'show-modal' }, 'Удалить страницу…'),
  modal({
    id: 'demo-confirm',
    title: 'Удалить эту страницу?',
    footer: stack({ direction: 'row', gap: 'sm' },
      button({
        variant: 'ghost',
        color: 'neutral',
        commandfor: 'demo-confirm',
        command: 'close',
      }, 'Отмена'),
      button({ color: 'danger' }, 'Удалить'),
    ),
  }, 'Это не отменить. Сгенерированный HTML исчезнет при следующей сборке.'),
)

Размеры

Маленькое

size: sm — около 24rem.

Среднее

Значение по умолчанию — около 32rem.

Большое

size: lg — около 48rem.
fragment(
  stack({ direction: 'row', gap: 'sm', wrap: true },
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-sm', command: 'show-modal' }, 'Маленькое'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-md', command: 'show-modal' }, 'Среднее'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-lg', command: 'show-modal' }, 'Большое'),
  ),
  modal({ id: 'demo-sm', size: 'sm', title: 'Маленькое' }, 'size: sm — около 24rem.'),
  modal({ id: 'demo-md', title: 'Среднее' }, 'Значение по умолчанию — около 32rem.'),
  modal({ id: 'demo-lg', size: 'lg', title: 'Большое' }, 'size: lg — около 48rem.'),
)

Формы внутри окна

Новая страница

fragment(
  button({ variant: 'soft', commandfor: 'demo-form', command: 'show-modal' }, 'Новая страница…'),
  modal({
    id: 'demo-form',
    title: 'Новая страница',
    footer: stack({ direction: 'row', gap: 'sm' },
      button({ variant: 'ghost', color: 'neutral', commandfor: 'demo-form', command: 'close' }, 'Отмена'),
      button({ type: 'submit' }, 'Создать'),
    ),
  },
    stack({ gap: 'md' },
      textField({ label: 'Заголовок', name: 'modal-title', placeholder: 'О проекте' }),
      selectField({ label: 'Расширение', name: 'modal-ext', options: ['.ht.js', '.ht.ts', '.ht.jsx'] }),
    ),
  ),
)

Без кнопки закрытия

closable: false убирает × в углу. Escape и клик снаружи всё равно закрывают окно; с closedby: 'closerequest' его закрывает только Escape.

Нажмите Escape

Или кликните в любом месте за пределами этого диалога.
fragment(
  button({ variant: 'outline', color: 'neutral', commandfor: 'demo-bare', command: 'show-modal' }, 'Без кнопки закрытия'),
  modal({ id: 'demo-bare', title: 'Нажмите Escape', closable: false },
    'Или кликните в любом месте за пределами этого диалога.',
  ),
)

Длинное содержимое

Тело прокручивается; шапка и подвал остаются на месте.

Заметки о выпуске

Изменение 1 — что-то починили.

Изменение 2 — что-то починили.

Изменение 3 — что-то починили.

Изменение 4 — что-то починили.

Изменение 5 — что-то починили.

Изменение 6 — что-то починили.

Изменение 7 — что-то починили.

Изменение 8 — что-то починили.

Изменение 9 — что-то починили.

Изменение 10 — что-то починили.

Изменение 11 — что-то починили.

Изменение 12 — что-то починили.

fragment(
  button({ variant: 'outline', color: 'neutral', commandfor: 'demo-long', command: 'show-modal' }, 'Длинное окно'),
  modal({
    id: 'demo-long',
    title: 'Заметки о выпуске',
    footer: button({ commandfor: 'demo-long', command: 'close' }, 'Закрыть'),
  },
    stack({ gap: 'md' },
      ...Array.from({ length: 12 }, (unused, index) =>
        text({ variant: 'small', tone: 'muted' }, 'Изменение ' + (index + 1) + ' — что-то починили.'),
      ),
    ),
  ),
)

Прокрутка фона

Страница за открытым окном не прокручивается. Это единственное, что модальный диалог оставляет на вас, и здесь оно сделано на CSS — без скрипта и без всякой инициализации. Передайте lockScroll: false, чтобы фон прокручивался как обычно.

Поддержка браузерами

Открыть диалог через command кнопки умеют все современные браузеры — Chrome 135, Firefox 144 и Safari 26.2 и новее. В более старом button() добавляет onclick, который загружает несколько сотен байт /su/dialog.js и делает то же самое — только там и только при первом клике. Закрывать окно кликом снаружи (closedby) Safari пока не умеет — там этим тоже занимается тот же файл.

Пропсы

ПропТипПо умолчаниюОписание
idstring—Обязателен. То, на что указывает commandfor кнопки-триггера.
titleChild—Заголовок и доступное имя диалога.
size'sm' | 'md' | 'lg''md'Максимальная ширина.
footerChild—Нижний ряд на собственной подкрашенной полосе.
closablebooleantrueПоказывать × в шапке.
closeLabelstring'Close'Доступное имя этой кнопки.
lockScrollbooleantrueНе давать странице за окном прокручиваться, пока оно открыто.

closeButton({ target }) рисует этот × отдельно — для шапки, которую вы собираете сами.