Dialog
Dialog meminta keputusan atau isian singkat di jendela di atas halaman, sementara halaman di belakangnya diredupkan.
Kapan dipakai
Section titled “Kapan dipakai”- Pakai untuk form singkat atau pilihan yang butuh perhatian penuh, misalnya mengubah judul rilis.
- Pakai Alert Dialog untuk memastikan aksi yang tidak bisa dibatalkan.
- Pakai Toast untuk memberi tahu sesuatu yang sudah terjadi.
- Jangan menaruh alur panjang di dialog; pakai halaman.
Lakukan dan jangan
Section titled “Lakukan dan jangan”Anatomi
Section titled “Anatomi”- 1Overlay
- 2Judul
- 3Isi
- 4Aksi, primary paling akhir
Judul, deskripsi, isi opsional, lalu aksi di footer. Jendelanya berlatar popover dengan garis border, radius-xl (16px), dan shadow-lg. Halaman di belakangnya diredupkan dengan token overlay.
Varian
Section titled “Varian”Hanya ada satu gaya. Taruh aksi utama paling akhir di footer.
| React | Vue | Flutter | Tipe | Default | Kegunaan |
|---|---|---|---|---|---|
open / defaultOpen |
v-model:open / default-open |
showShadDialog |
boolean | false |
Terbuka atau tidak. |
onOpenChange |
@update:open |
nilai kembali showShadDialog |
function | tidak ada | Jalan saat dibuka atau ditutup. |
DialogTrigger render |
DialogTrigger as-child |
onPressed |
elemen | button | Kontrol yang membukanya. |
import { useId } from "react"import { Button } from "@/components/ui/button"import { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger,} from "@/components/ui/dialog"import { Field, FieldLabel } from "@/components/ui/field"import { Input } from "@/components/ui/input"
export default function DialogDemo() { const id = useId() return ( <Dialog> <DialogTrigger render={<Button variant="outline" />}>Ubah judul</DialogTrigger> <DialogContent> <DialogHeader> <DialogTitle>Ubah judul rilis</DialogTitle> <DialogDescription>Judul baru tampil di semua toko musik setelah dikirim ulang.</DialogDescription> </DialogHeader> <Field> <FieldLabel htmlFor={`${id}-title`}>Judul rilis</FieldLabel> <Input id={`${id}-title`} defaultValue="Senja di Kota" /> </Field> <DialogFooter> <DialogClose render={<Button variant="outline" />}>Batal</DialogClose> <DialogClose render={<Button />}>Simpan</DialogClose> </DialogFooter> </DialogContent> </Dialog> )}<script setup lang="ts">import { useId } from "vue"import { Button } from "@/components/ui/button"import { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger,} from "@/components/ui/dialog"import { Field, FieldLabel } from "@/components/ui/field"import { Input } from "@/components/ui/input"
const id = useId()</script>
<template> <Dialog> <DialogTrigger as-child> <Button variant="outline">Ubah judul</Button> </DialogTrigger> <DialogContent> <DialogHeader> <DialogTitle>Ubah judul rilis</DialogTitle> <DialogDescription>Judul baru tampil di semua toko musik setelah dikirim ulang.</DialogDescription> </DialogHeader> <Field> <FieldLabel :for="`${id}-title`">Judul rilis</FieldLabel> <Input :id="`${id}-title`" default-value="Senja di Kota" /> </Field> <DialogFooter> <DialogClose as-child><Button variant="outline">Batal</Button></DialogClose> <DialogClose as-child><Button>Simpan</Button></DialogClose> </DialogFooter> </DialogContent> </Dialog></template>import 'package:flutter/widgets.dart';import 'package:shadcn_ui/shadcn_ui.dart';
class DialogDemo extends StatelessWidget { const DialogDemo({super.key});
@override Widget build(BuildContext context) { return ShadButton.outline( child: const Text('Ubah judul'), onPressed: () => showShadDialog( context: context, builder: (context) => ShadDialog( title: const Text('Ubah judul rilis'), description: const Text('Judul baru tampil di semua toko musik setelah dikirim ulang.'), actions: [ ShadButton.outline(child: const Text('Batal'), onPressed: () => Navigator.of(context).pop()), ShadButton(child: const Text('Simpan'), onPressed: () => Navigator.of(context).pop()), ], child: ShadInputFormField(id: 'release-title', label: const Text('Judul rilis'), initialValue: 'Senja di Kota'), ), ), ); }}Pasang
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/dialog.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/dialog.jsonTombol yang ikut terpasang adalah tombol Sosialoka.
Aksesibilitas
Section titled “Aksesibilitas”- Dirender dengan
role="dialog"dan judul sebagai namanya. Fokus pindah ke dalam dialog, lalu kembali ke pemicunya saat ditutup. - Escape menutupnya, dan fokus tetap di dalam selama dialog terbuka.
