Modal

Modal adalah sebuah <dialog>. Tombol mana pun dengan commandfor yang menunjuk id modalnya dan command: 'show-modal' akan membukanya secara modal: halaman di belakangnya menjadi inert, jadi fokus dan pembaca layar tetap di dalam. Tanpa skrip di mana pun — latar, Escape, dan klik di luar semuanya dimiliki peramban.

Itulah sebabnya id bersifat wajib dan komponennya melempar galat tanpa itu: id-nya adalah keseluruhan sambungannya.

Setiap modal di halaman ini benar-benar terbuka — cobalah.

Bangun ulang situsnya?

Ini menjalankan sitelo build dan menerbitkan ulang dist/.
fragment(
  button({ commandfor: 'demo-basic', command: 'show-modal' }, 'Buka modal'),
  modal({ id: 'demo-basic', title: 'Bangun ulang situsnya?' },
    'Ini menjalankan sitelo build dan menerbitkan ulang dist/.',
  ),
)

Dengan kaki

Tombol tutup adalah tombol mana pun yang menunjuk id yang sama dengan command: 'close'.

Hapus halaman ini?

Ini tidak bisa dibatalkan. HTML yang dihasilkan akan dihapus pada build berikutnya.
fragment(
  button({ color: 'danger', commandfor: 'demo-confirm', command: 'show-modal' }, 'Hapus halaman…'),
  modal({
    id: 'demo-confirm',
    title: 'Hapus halaman ini?',
    footer: stack({ direction: 'row', gap: 'sm' },
      button({
        variant: 'ghost',
        color: 'neutral',
        commandfor: 'demo-confirm',
        command: 'close',
      }, 'Batal'),
      button({ color: 'danger' }, 'Hapus'),
    ),
  }, 'Ini tidak bisa dibatalkan. HTML yang dihasilkan akan dihapus pada build berikutnya.'),
)

Ukuran

Kecil

size: sm — sekitar 24rem.

Sedang

Bawaannya — sekitar 32rem.

Besar

size: lg — sekitar 48rem.
fragment(
  stack({ direction: 'row', gap: 'sm', wrap: true },
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-sm', command: 'show-modal' }, 'Kecil'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-md', command: 'show-modal' }, 'Sedang'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-lg', command: 'show-modal' }, 'Besar'),
  ),
  modal({ id: 'demo-sm', size: 'sm', title: 'Kecil' }, 'size: sm — sekitar 24rem.'),
  modal({ id: 'demo-md', title: 'Sedang' }, 'Bawaannya — sekitar 32rem.'),
  modal({ id: 'demo-lg', size: 'lg', title: 'Besar' }, 'size: lg — sekitar 48rem.'),
)

Formulir di dalam modal

Halaman baru

fragment(
  button({ variant: 'soft', commandfor: 'demo-form', command: 'show-modal' }, 'Halaman baru…'),
  modal({
    id: 'demo-form',
    title: 'Halaman baru',
    footer: stack({ direction: 'row', gap: 'sm' },
      button({ variant: 'ghost', color: 'neutral', commandfor: 'demo-form', command: 'close' }, 'Batal'),
      button({ type: 'submit' }, 'Buat'),
    ),
  },
    stack({ gap: 'md' },
      textField({ label: 'Judul', name: 'modal-title', placeholder: 'Tentang' }),
      selectField({ label: 'Ekstensi', name: 'modal-ext', options: ['.ht.js', '.ht.ts', '.ht.jsx'] }),
    ),
  ),
)

Tanpa tombol tutup

closable: false membuang × di sudutnya. Escape dan klik di luar tetap menutupnya; dengan closedby: 'closerequest' hanya Escape yang menutupnya.

Tekan Escape

Atau klik di mana saja di luar dialog ini.
fragment(
  button({ variant: 'outline', color: 'neutral', commandfor: 'demo-bare', command: 'show-modal' }, 'Tanpa tombol tutup'),
  modal({ id: 'demo-bare', title: 'Tekan Escape', closable: false },
    'Atau klik di mana saja di luar dialog ini.',
  ),
)

Konten panjang

Badannya bergulir; kepala dan kakinya tetap di tempat.

Catatan rilis

Perubahan 1 — ada yang diperbaiki.

Perubahan 2 — ada yang diperbaiki.

Perubahan 3 — ada yang diperbaiki.

Perubahan 4 — ada yang diperbaiki.

Perubahan 5 — ada yang diperbaiki.

Perubahan 6 — ada yang diperbaiki.

Perubahan 7 — ada yang diperbaiki.

Perubahan 8 — ada yang diperbaiki.

Perubahan 9 — ada yang diperbaiki.

Perubahan 10 — ada yang diperbaiki.

Perubahan 11 — ada yang diperbaiki.

Perubahan 12 — ada yang diperbaiki.

fragment(
  button({ variant: 'outline', color: 'neutral', commandfor: 'demo-long', command: 'show-modal' }, 'Modal panjang'),
  modal({
    id: 'demo-long',
    title: 'Catatan rilis',
    footer: button({ commandfor: 'demo-long', command: 'close' }, 'Tutup'),
  },
    stack({ gap: 'md' },
      ...Array.from({ length: 12 }, (unused, index) =>
        text({ variant: 'small', tone: 'muted' }, 'Perubahan ' + (index + 1) + ' — ada yang diperbaiki.'),
      ),
    ),
  ),
)

Penggulungan latar

Halaman di belakang modal yang terbuka tidak tergulir. Itulah satu-satunya hal yang diserahkan dialog modal kepada Anda, dan di sini ia dikerjakan dengan CSS — tanpa skrip, dan tanpa apa pun yang perlu diinisialisasi. Berikan lockScroll: false agar latarnya tergulir seperti biasa.

Dukungan peramban

Membuka dialog lewat command sebuah tombol didukung setiap peramban masa kini — Chrome 135, Firefox 144, dan Safari 26.2 ke atas. Di peramban yang lebih tua, button() menambahkan onclick yang memuat beberapa ratus bita /su/dialog.js untuk melakukan hal yang sama — hanya di sana, dan hanya pada klik pertama. Safari belum menutup dialog saat diklik di luar (closedby), dan berkas yang sama menanganinya di sana.

Props

PropTipeBawaanDeskripsi
idstring—Wajib. Apa yang ditunjuk commandfor sebuah pemicu.
titleChild—Judul, sekaligus nama dialognya yang dapat diakses.
size'sm' | 'md' | 'lg''md'Lebar maksimum.
footerChild—Baris bawah, pada pita berwarnanya sendiri.
closablebooleantrueMenampilkan × di kepalanya.
closeLabelstring'Close'Nama yang dapat diakses untuk tombol itu.
lockScrollbooleantrueMenghentikan penggulungan halaman di belakangnya selagi ia terbuka.

closeButton({ target }) merender × itu sendiri, untuk kepala yang Anda bangun sendiri.