# Dropdown Menu

> Mengumpulkan beberapa aksi di balik satu tombol.

Dropdown menu mengumpulkan beberapa aksi di balik satu tombol, misalnya aksi sebuah baris tabel.

## Kapan dipakai

- Pakai kalau satu baris atau kartu punya lebih banyak aksi daripada yang muat sebagai tombol.
- Taruh aksi yang paling sering dipakai di atas, dan aksi destructive di bawah setelah pemisah.
- Untuk memilih nilai, pakai [Select](https://design.sosialoka.tech/id/components/select/), bukan menu.

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

### Lakukan dan jangan

- **Lakukan:** Taruh item destruktif paling akhir, setelah pemisah.
- **Jangan:** Jangan taruh item destruktif paling atas, tempat klik cepat mendarat.

## Anatomi

1. Tombol pemicu
2. Menu di elevation-lg
3. Item yang disorot
4. Item destruktif, paling akhir setelah pemisah

Pemicu, biasanya tombol ikon ghost, dan popup berlatar `popover` dengan garis `border`, `radius-lg`, dan `shadow-lg`. Item memakai `radius-md` dan disorot dengan `accent`.

## Varian

Item bisa `destructive` (`text-destructive`), checkbox, radio, atau sub-menu.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `DropdownMenuTrigger render` | `DropdownMenuTrigger as-child` | `child` dengan `controller.toggle` | elemen | button | Kontrol yang membukanya. |
| `DropdownMenuItem variant` | `DropdownMenuItem variant` | tidak ada | `default` \| `destructive` | `default` | Menandai aksi destructive. |
| `onClick` di item | `@select` di item | `onPressed` di `ShadContextMenuItem` | function | tidak ada | Menjalankan aksi. |

## Kode

**React**
```tsx
import { MoreHorizontalIcon } from "lucide-react"
import { Button } from "@/components/ui/button"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuSeparator,
  DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"

export default function DropdownMenuDemo() {
  return (
    <DropdownMenu>
      <DropdownMenuTrigger render={<Button variant="ghost" size="icon" aria-label="Aksi" />}>
        <MoreHorizontalIcon />
      </DropdownMenuTrigger>
      <DropdownMenuContent>
        <DropdownMenuItem>Lihat</DropdownMenuItem>
        <DropdownMenuItem>Ubah</DropdownMenuItem>
        <DropdownMenuSeparator />
        <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem>
      </DropdownMenuContent>
    </DropdownMenu>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { MoreHorizontal } from "@lucide/vue"
import { Button } from "@/components/ui/button"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuSeparator,
  DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
</script>

<template>
  <DropdownMenu>
    <DropdownMenuTrigger as-child>
      <Button variant="ghost" size="icon" aria-label="Aksi"><MoreHorizontal /></Button>
    </DropdownMenuTrigger>
    <DropdownMenuContent>
      <DropdownMenuItem>Lihat</DropdownMenuItem>
      <DropdownMenuItem>Ubah</DropdownMenuItem>
      <DropdownMenuSeparator />
      <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem>
    </DropdownMenuContent>
  </DropdownMenu>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class DropdownMenuDemo extends StatefulWidget {
  const DropdownMenuDemo({super.key});

  @override
  State<DropdownMenuDemo> createState() => _DropdownMenuDemoState();
}

class _DropdownMenuDemoState extends State<DropdownMenuDemo> {
  final controller = ShadContextMenuController();

  @override
  void dispose() {
    controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return ShadContextMenu(
      controller: controller,
      items: const [
        ShadContextMenuItem(child: Text('Lihat')),
        ShadContextMenuItem(child: Text('Ubah')),
        ShadSeparator.horizontal(margin: EdgeInsets.symmetric(vertical: 4)),
        ShadContextMenuItem(child: Text('Hapus')),
      ],
      child: ShadIconButton.ghost(
        icon: const Icon(LucideIcons.ellipsis),
        onPressed: controller.toggle,
      ),
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Dirender dengan `role="menu"` dan `menuitem`. Tombol panah berpindah, Enter menjalankan, Escape menutup.
- Pemicu berisi ikon saja wajib punya `aria-label`.
