# Popover

> Menampilkan konten tambahan atau form kecil di samping pemicunya.

Popover membuka panel kecil di samping tombol yang membukanya, untuk konten tambahan atau tugas singkat yang tidak butuh dialog.

## Kapan dipakai

- Pakai untuk membagikan tautan, memasang filter cepat, atau menampilkan detail satu item.
- Pakai [Tooltip](https://design.sosialoka.tech/id/components/tooltip/) untuk nama satu baris pada tombol ikon, dan [Dialog](https://design.sosialoka.tech/id/components/dialog/) untuk tugas yang butuh perhatian penuh.
- Pakai [Dropdown Menu](https://design.sosialoka.tech/id/components/dropdown-menu/) untuk daftar aksi.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/popover/_

## Anatomi

1. Pemicu
2. Panah
3. Isi

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

Hanya ada satu gaya. Pilih sisinya (`top`, `right`, `bottom`, `left`) dan perataannya (`start`, `center`, `end`).

## Props

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

## Kode

**React**
```tsx
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>
  )
}
```

**Vue**
```vue
<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>
```

**Flutter**
```dart
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

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/popover.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/popover.json
```

## 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".
