Modal
Di halaman ini
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.
Modal dasar
Setiap modal di halaman ini benar-benar terbuka — cobalah.
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'.
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
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
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.
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.
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
| Prop | Tipe | Bawaan | Deskripsi |
|---|---|---|---|
id | string | — | Wajib. Apa yang ditunjuk commandfor sebuah pemicu. |
title | Child | — | Judul, sekaligus nama dialognya yang dapat diakses. |
size | 'sm' | 'md' | 'lg' | 'md' | Lebar maksimum. |
footer | Child | — | Baris bawah, pada pita berwarnanya sendiri. |
closable | boolean | true | Menampilkan × di kepalanya. |
closeLabel | string | 'Close' | Nama yang dapat diakses untuk tombol itu. |
lockScroll | boolean | true | Menghentikan penggulungan halaman di belakangnya selagi ia terbuka. |
closeButton({ target }) merender × itu sendiri, untuk kepala yang Anda bangun sendiri.