# Dropdown Menu

> Lists actions behind one button.

A dropdown menu lists actions behind one button, such as the actions of a table row.

## When to use

- Use it when a row or card has more actions than fit as buttons.
- Put the most used action first and destructive actions last, after a separator.
- Use a [Select](https://design.sosialoka.tech/components/select/) to pick a value, not a menu.

_Live preview of the React and Vue versions: https://design.sosialoka.tech/components/dropdown-menu/_

### Do and don't

- **Do:** Put a destructive item last, after a separator.
- **Don't:** Don't put a destructive item first, where a quick click lands.

## Anatomy

1. Trigger button
2. Menu on elevation-lg
3. Highlighted item
4. Destructive item, last and after a separator

A trigger, usually a ghost icon button, and a popup on `popover` with a `border`, `radius-lg` and `shadow-lg`. Items use `radius-md` and highlight with `accent`.

## Variants

Items can be `destructive` (`text-destructive`), checkboxes, radio items or sub-menus.

## Props

| React | Vue | Flutter | Type | Default | Use |
| --- | --- | --- | --- | --- | --- |
| `DropdownMenuTrigger render` | `DropdownMenuTrigger as-child` | `child` with `controller.toggle` | element | button | The control that opens it. |
| `DropdownMenuItem variant` | `DropdownMenuItem variant` | none | `default` \| `destructive` | `default` | Marks a destructive action. |
| `onClick` on an item | `@select` on an item | `onPressed` on `ShadContextMenuItem` | function | none | Runs the action. |

## Code

**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,
      ),
    );
  }
}
```

## Install

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

## Accessibility

- Renders `role="menu"` and `menuitem`; arrow keys move, Enter runs, Escape closes.
- Icon-only triggers need an `aria-label`.
