Dropdown menu
A menu on Base UI Menu with checkbox, radio and sub-menu rows.
Default
import { ArchiveIcon, BinIcon, CopyIcon, PenLineIcon, Share2Icon } from "@keyline-icons/react"
import { Button } from "@/components/ui/button"
import {
DropdownMenu,
DropdownMenuContent,
DropdownMenuGroup,
DropdownMenuItem,
DropdownMenuLabel,
DropdownMenuSeparator,
DropdownMenuShortcut,
DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
export default function DropdownMenuDefault() {
return (
<DropdownMenu>
<DropdownMenuTrigger render={<Button variant="outline" />}>Project actions</DropdownMenuTrigger>
<DropdownMenuContent className="w-52">
<DropdownMenuGroup>
<DropdownMenuLabel>Website refresh</DropdownMenuLabel>
<DropdownMenuItem>
<PenLineIcon />
Rename
<DropdownMenuShortcut>F2</DropdownMenuShortcut>
</DropdownMenuItem>
<DropdownMenuItem>
<CopyIcon />
Duplicate
<DropdownMenuShortcut>⌘D</DropdownMenuShortcut>
</DropdownMenuItem>
<DropdownMenuItem disabled>
<Share2Icon />
Share
</DropdownMenuItem>
</DropdownMenuGroup>
<DropdownMenuSeparator />
<DropdownMenuItem>
<ArchiveIcon />
Archive
</DropdownMenuItem>
<DropdownMenuItem variant="destructive">
<BinIcon />
Delete
<DropdownMenuShortcut>⌘⌫</DropdownMenuShortcut>
</DropdownMenuItem>
</DropdownMenuContent>
</DropdownMenu>
)
}
Checkbox items
"use client"
import { useState } from "react"
import { Button } from "@/components/ui/button"
import {
DropdownMenu,
DropdownMenuCheckboxItem,
DropdownMenuContent,
DropdownMenuGroup,
DropdownMenuLabel,
DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
const columns = ["Status", "Due date", "Amount", "Owner"]
export default function DropdownMenuCheckboxItems() {
const [shown, setShown] = useState(["Status", "Due date"])
return (
<DropdownMenu>
<DropdownMenuTrigger render={<Button variant="outline" />}>Columns</DropdownMenuTrigger>
<DropdownMenuContent className="w-44">
<DropdownMenuGroup>
<DropdownMenuLabel>Show columns</DropdownMenuLabel>
{columns.map((column) => (
<DropdownMenuCheckboxItem
key={column}
checked={shown.includes(column)}
disabled={column === "Owner"}
onCheckedChange={(checked) =>
setShown((current) => (checked ? [...current, column] : current.filter((name) => name !== column)))
}
>
{column}
</DropdownMenuCheckboxItem>
))}
</DropdownMenuGroup>
</DropdownMenuContent>
</DropdownMenu>
)
}
Radio items
"use client"
import { useState } from "react"
import { Button } from "@/components/ui/button"
import {
DropdownMenu,
DropdownMenuContent,
DropdownMenuGroup,
DropdownMenuLabel,
DropdownMenuRadioGroup,
DropdownMenuRadioItem,
DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
const orders = ["Newest first", "Oldest first", "Amount", "Due date"]
export default function DropdownMenuRadioItems() {
const [order, setOrder] = useState("Newest first")
return (
<DropdownMenu>
<DropdownMenuTrigger render={<Button variant="outline" />}>Sort: {order}</DropdownMenuTrigger>
<DropdownMenuContent className="w-44">
<DropdownMenuGroup>
<DropdownMenuLabel>Sort invoices by</DropdownMenuLabel>
<DropdownMenuRadioGroup value={order} onValueChange={setOrder}>
{orders.map((name) => (
<DropdownMenuRadioItem key={name} value={name}>
{name}
</DropdownMenuRadioItem>
))}
</DropdownMenuRadioGroup>
</DropdownMenuGroup>
</DropdownMenuContent>
</DropdownMenu>
)
}
With a submenu
import { FolderArrowRightIcon, MoreHorizontalIcon, PinIcon, TagIcon } from "@keyline-icons/react"
import { Button } from "@/components/ui/button"
import {
DropdownMenu,
DropdownMenuContent,
DropdownMenuItem,
DropdownMenuSub,
DropdownMenuSubContent,
DropdownMenuSubTrigger,
DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
export default function DropdownMenuWithASubmenu() {
return (
<DropdownMenu>
<DropdownMenuTrigger render={<Button variant="outline" size="icon" aria-label="Task actions" />}>
<MoreHorizontalIcon />
</DropdownMenuTrigger>
<DropdownMenuContent align="end" className="w-44">
<DropdownMenuItem>
<PinIcon />
Pin to the top
</DropdownMenuItem>
<DropdownMenuItem>
<TagIcon />
Add a label
</DropdownMenuItem>
<DropdownMenuSub>
<DropdownMenuSubTrigger>
<FolderArrowRightIcon />
Move to
</DropdownMenuSubTrigger>
<DropdownMenuSubContent>
<DropdownMenuItem>Website refresh</DropdownMenuItem>
<DropdownMenuItem>Billing migration</DropdownMenuItem>
<DropdownMenuItem>Mobile onboarding</DropdownMenuItem>
</DropdownMenuSubContent>
</DropdownMenuSub>
</DropdownMenuContent>
</DropdownMenu>
)
}
Installation
npx shadcn@latest add @khaeli/dropdown-menubunx --bun shadcn@latest add @khaeli/dropdown-menuInstall @khaeli/foundation first: this item's styling lives in its tokens and [data-slot] rules.
Installs with
- Registry items
- npm packages
- @base-ui/react ^1.7.0
- @keyline-icons/react ^2.2.0
Keyboard
EnterSpaceArrow Down- On the trigger, open the menu and focus its first row.
Arrow DownArrow Up- Move between rows and wrap at either end. A disabled row is still reached and is announced as disabled; Enter does nothing on it.
HomeEnd- Go to the first and the last row.
A letter- Moves to the next row that starts with it.
EnterSpace- Run the row and close the menu. On a checkbox or radio row they change the value and the menu stays open.
Arrow RightArrow Left- On a sub-menu row, Arrow Right (or Enter) opens the sub-menu and focuses its first row. Arrow Left closes it and returns to its row.
Escape- Closes the menu and returns focus to the trigger. In a sub-menu it closes the sub-menu only.
Tab- Closes the menu and moves focus to the control after the trigger.
Accessible name
- The menu is named by its trigger. An icon-only trigger needs an
aria-label, which then names the menu too. DropdownMenuLabelnames theDropdownMenuGroupit sits in, so keep it inside one.- Checkbox and radio rows are announced with their state (
menuitemcheckbox,menuitemradio,aria-checked). DropdownMenuShortcutis read as part of the row's name. It shows the keys and binds nothing.variant="destructive"does not colour the row: its text matches the other rows and only its icon is drawn stronger. Say what the row does in its label.
Registry JSON
The item as the shadcn CLI reads it, with every file it ships: https://ui.khaeli.com/r/dropdown-menu.json