Popover
Popover membuka panel kecil di samping tombol yang membukanya, untuk konten tambahan atau tugas singkat yang tidak butuh dialog.
Kapan dipakai
Section titled “Kapan dipakai”- Pakai untuk membagikan tautan, memasang filter cepat, atau menampilkan detail satu item.
- Pakai Tooltip untuk nama satu baris pada tombol ikon, dan Dialog untuk tugas yang butuh perhatian penuh.
- Pakai Dropdown Menu untuk daftar aksi.
Anatomi
Section titled “Anatomi”- 1Pemicu
- 2Panah
- 3Isi
Panel berlatar popover dengan border, radius-lg, dan shadow-lg, lebar bawaan 288px, di samping pemicunya. Panel dirender di luar alur halaman, jadi tidak pernah terpotong kartu. Judul dan satu kalimat deskripsi boleh ada di bagian atasnya.
Varian
Section titled “Varian”Hanya ada satu gaya. Pilih sisinya (top, right, bottom, left) dan perataannya (start, center, end).
| React | Vue | Flutter | Tipe | Default | Kegunaan |
|---|---|---|---|---|---|
open / onOpenChange |
v-model:open |
controller |
boolean | false |
Membuka dan menutup lewat kode. |
side di PopoverContent |
side di PopoverContent |
anchor |
teks | bottom |
Sisi pemicu tempat panel terbuka. |
align di PopoverContent |
align di PopoverContent |
anchor |
teks | center |
Perataan panel terhadap pemicu. |
PopoverTrigger render |
PopoverTrigger as-child |
child |
elemen | tidak ada | Tombol yang membukanya. |
import { useId } from "react"import { Button } from "@/components/ui/button"import { Input } from "@/components/ui/input"import { Label } from "@/components/ui/label"import { Popover, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger } from "@/components/ui/popover"
export default function PopoverDemo() { const id = useId() return ( <Popover> <PopoverTrigger render={<Button variant="outline" />}>Bagikan</PopoverTrigger> <PopoverContent> <PopoverHeader> <PopoverTitle>Bagikan rilis</PopoverTitle> <PopoverDescription>Siapa pun yang punya tautan ini bisa mendengarkan.</PopoverDescription> </PopoverHeader> <div className="grid gap-2"> <Label htmlFor={`${id}-link`}>Tautan rilis</Label> <div className="flex gap-2"> <Input id={`${id}-link`} readOnly defaultValue="https://contoh.id/senja-di-kota" /> <Button>Salin</Button> </div> </div> </PopoverContent> </Popover> )}<script setup lang="ts">import { useId } from "vue"import { Button } from "@/components/ui/button"import { Input } from "@/components/ui/input"import { Label } from "@/components/ui/label"import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover"
const id = useId()</script>
<template> <Popover> <PopoverTrigger as-child> <Button variant="outline">Bagikan</Button> </PopoverTrigger> <PopoverContent class="grid gap-2.5" :aria-describedby="`${id}-description`"> <div class="grid gap-1"> <p class="font-medium">Bagikan rilis</p> <p :id="`${id}-description`" class="text-muted-foreground">Siapa pun yang punya tautan ini bisa mendengarkan.</p> </div> <div class="grid gap-2"> <Label :for="`${id}-link`">Tautan rilis</Label> <div class="flex gap-2"> <Input :id="`${id}-link`" readonly default-value="https://contoh.id/senja-di-kota" /> <Button>Salin</Button> </div> </div> </PopoverContent> </Popover></template>import 'package:flutter/widgets.dart';import 'package:shadcn_ui/shadcn_ui.dart';
class PopoverDemo extends StatefulWidget { const PopoverDemo({super.key});
@override State<PopoverDemo> createState() => _PopoverDemoState();}
class _PopoverDemoState extends State<PopoverDemo> { final controller = ShadPopoverController();
@override void dispose() { controller.dispose(); super.dispose(); }
@override Widget build(BuildContext context) { final theme = ShadTheme.of(context); return ShadPopover( controller: controller, popover: (context) => SizedBox( width: 288, child: Column( mainAxisSize: MainAxisSize.min, crossAxisAlignment: CrossAxisAlignment.start, spacing: 8, children: [ Text('Bagikan rilis', style: theme.textTheme.large), Text('Siapa pun yang punya tautan ini bisa mendengarkan.', style: theme.textTheme.muted), Row( spacing: 8, children: [ const Expanded( child: ShadInput(initialValue: 'https://contoh.id/senja-di-kota', readOnly: true), ), ShadButton(child: const Text('Salin'), onPressed: () {}), ], ), ], ), ), child: ShadButton.outline(onPressed: controller.toggle, child: const Text('Bagikan')), ); }}Pasang
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/popover.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/popover.jsonAksesibilitas
Section titled “Aksesibilitas”- Panelnya berupa dialog yang mengambil fokus saat terbuka dan mengembalikannya ke pemicu saat tertutup.
- Escape dan klik di luar panel menutupnya.
- Beri pemicu nama yang jelas, misalnya “Bagikan”.
