Dialog
Pop-up modal yang direka untuk menarik perhatian pengguna untuk tindakan atau mesej penting. Ia terdiri daripada tiga komponen utama, iaitu Header, Content, dan Footer.
Penggunaan
Contoh
Pencetus
Gunakan DialogTrigger
untuk membungkus elemen pencetus yang membuka dialog. Contoh di bawah menunjukkan tiga butang yang berbeza membuka dialog yang sama.
Keadaan Tidak Terkawal vs Terkawal
Untuk menggunakan dialog dalam keadaan tidak terkawal, tetapkan prop defaultOpen
kepada keadaan awal dialog.
Untuk menggunakan dialog dalam keadaan terkawal, gunakan prop open
dan onOpenChange
untuk mengendalikan keadaan secara programatik.
Tidak Terkawal
Terkawal
Boleh Ditutup
Untuk menghalang pengguna daripada menutup dialog, tetapkan prop dismissible
kepada false
pada DialogBody
. Secara lalai, dialog boleh ditutup.
Anda boleh melampirkan fungsi panggilan balik kepada prop onDismiss
untuk mengendalikan acara penutupan.
Sempadan
Sempadan boleh ditambah pada DialogHeader
dan DialogFooter
dengan menetapkan prop border
kepada true
.
Penjajaran
Anda boleh menetapkan align
pada DialogFooter
untuk menjajarkan anak kepada start
, end
, atau full
lebar dialog. Secara lalai, penjajaran ditetapkan kepada end
.
Mula
Penuh
Akhir
Tindakan
Anda boleh menambah tindakan khas pada dialog dengan menggunakan prop action
pada DialogFooter
.
Props
Dialog
Prop | Type | Default |
---|---|---|
open | boolean | false |
defaultOpen | boolean | false |
onOpenChange | (open: boolean) => void | - |
DialogBody
Prop | Type | Default |
---|---|---|
dismissible | boolean | true |
hideClose | boolean | false |
onDismiss | () => void | - |
DialogHeader
Prop | Type | Default |
---|---|---|
border | boolean | false |
DialogFooter
Prop | Type | Default |
---|---|---|
border | boolean | false |
align | start | end | full | end |
action | ReactNode | - |