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 | - |