File: dropdown-menu.md | Updated: 11/15/2025
ThemesThemes PrimitivesPrimitives IconsIcons ColorsColors
Documentation Case studies Blog
Search
/
Introduction Getting started Accessibility Releases
Styling Animation Composition Server-side rendering
Accordion
Alert Dialog
Aspect Ratio
Avatar
Checkbox
Collapsible
Context Menu
Dialog
Dropdown Menu
Form
Preview
Hover Card
Label
Menubar
Navigation Menu
One-Time Password Field
Preview
Password Toggle Field
Preview
Popover
Progress
Radio Group
Scroll Area
Select
Separator
Slider
Switch
Tabs
Toast
Toggle
Toggle Group
Toolbar
Tooltip
Accessible Icon Direction Provider Portal Slot Visually Hidden
Components
Displays a menu to the userāsuch as a set of actions or functionsātriggered by a button.
index.jsxindex.jsxstyles.cssstyles.css
CSS
import * as React from "react";
import { DropdownMenu } from "radix-ui";
import {
HamburgerMenuIcon,
DotFilledIcon,
CheckIcon,
ChevronRightIcon,
} from "@radix-ui/react-icons";
import "./styles.css";
const DropdownMenuDemo = () => {
const [bookmarksChecked, setBookmarksChecked] = React.useState(true);
const [urlsChecked, setUrlsChecked] = React.useState(false);
const [person, setPerson] = React.useState("pedro");
return (
<DropdownMenu.Root>
<DropdownMenu.Trigger asChild>
<button className="IconButton" aria-label="Customise options">
<HamburgerMenuIcon />
</button>
</DropdownMenu.Trigger>
<DropdownMenu.Portal>
<DropdownMenu.Content className="DropdownMenuContent" sideOffset={5}>
<DropdownMenu.Item className="DropdownMenuItem">
New Tab <div className="RightSlot">ā+T</div>
</DropdownMenu.Item>
<DropdownMenu.Item className="DropdownMenuItem">
New Window <div className="RightSlot">ā+N</div>
</DropdownMenu.Item>
<DropdownMenu.Item className="DropdownMenuItem" disabled>
New Private Window <div className="RightSlot">ā§+ā+N</div>
</DropdownMenu.Item>
<DropdownMenu.Sub>
<DropdownMenu.SubTrigger className="DropdownMenuSubTrigger">
More Tools
<div className="RightSlot">
<ChevronRightIcon />
</div>
</DropdownMenu.SubTrigger>
<DropdownMenu.Portal>
<DropdownMenu.SubContent
className="DropdownMenuSubContent"
sideOffset={2}
alignOffset={-5}
>
<DropdownMenu.Item className="DropdownMenuItem">
Save Page As⦠<div className="RightSlot">ā+S</div>
</DropdownMenu.Item>
<DropdownMenu.Item className="DropdownMenuItem">
Create Shortcutā¦
</DropdownMenu.Item>
<DropdownMenu.Item className="DropdownMenuItem">
Name Windowā¦
</DropdownMenu.Item>
<DropdownMenu.Separator className="DropdownMenu.Separator" />
<DropdownMenu.Item className="DropdownMenuItem">
Developer Tools
</DropdownMenu.Item>
</DropdownMenu.SubContent>
</DropdownMenu.Portal>
</DropdownMenu.Sub>
<DropdownMenu.Separator className="DropdownMenuSeparator" />
<DropdownMenu.CheckboxItem
className="DropdownMenuCheckboxItem"
checked={bookmarksChecked}
onCheckedChange={setBookmarksChecked}
>
<DropdownMenu.ItemIndicator className="DropdownMenuItemIndicator">
<CheckIcon />
</DropdownMenu.ItemIndicator>
Show Bookmarks <div className="RightSlot">ā+B</div>
</DropdownMenu.CheckboxItem>
<DropdownMenu.CheckboxItem
className="DropdownMenuCheckboxItem"
checked={urlsChecked}
onCheckedChange={setUrlsChecked}
>
<DropdownMenu.ItemIndicator className="DropdownMenuItemIndicator">
<CheckIcon />
</DropdownMenu.ItemIndicator>
Show Full URLs
</DropdownMenu.CheckboxItem>
<DropdownMenu.Separator className="DropdownMenuSeparator" />
<DropdownMenu.Label className="DropdownMenuLabel">
People
</DropdownMenu.Label>
<DropdownMenu.RadioGroup value={person} onValueChange={setPerson}>
<DropdownMenu.RadioItem
className="DropdownMenuRadioItem"
value="pedro"
>
<DropdownMenu.ItemIndicator className="DropdownMenuItemIndicator">
<DotFilledIcon />
</DropdownMenu.ItemIndicator>
Pedro Duarte
</DropdownMenu.RadioItem>
<DropdownMenu.RadioItem
className="DropdownMenuRadioItem"
value="colm"
>
<DropdownMenu.ItemIndicator className="DropdownMenuItemIndicator">
<DotFilledIcon />
</DropdownMenu.ItemIndicator>
Colm Tuite
</DropdownMenu.RadioItem>
</DropdownMenu.RadioGroup>
<DropdownMenu.Arrow className="DropdownMenuArrow" />
</DropdownMenu.Content>
</DropdownMenu.Portal>
</DropdownMenu.Root>
);
};
export default DropdownMenuDemo;
Can be controlled or uncontrolled.
Supports submenus with configurable reading direction.
Supports items, labels, groups of items.
Supports checkable items (single or multiple) with optional indeterminate state.
Supports modal and non-modal modes.
Customize side, alignment, offsets, collision handling.
Optionally render a pointing arrow.
Focus is fully managed.
Full keyboard navigation.
Typeahead support.
Dismissing and layering behavior is highly customizable.
Install the component from your command line.
npm install @radix-ui/react-dropdown-menu
Import all parts and piece them together.
import { DropdownMenu } from "radix-ui";
export default () => (
<DropdownMenu.Root>
<DropdownMenu.Trigger />
<DropdownMenu.Portal>
<DropdownMenu.Content>
<DropdownMenu.Label />
<DropdownMenu.Item />
<DropdownMenu.Group>
<DropdownMenu.Item />
</DropdownMenu.Group>
<DropdownMenu.CheckboxItem>
<DropdownMenu.ItemIndicator />
</DropdownMenu.CheckboxItem>
<DropdownMenu.RadioGroup>
<DropdownMenu.RadioItem>
<DropdownMenu.ItemIndicator />
</DropdownMenu.RadioItem>
</DropdownMenu.RadioGroup>
<DropdownMenu.Sub>
<DropdownMenu.SubTrigger />
<DropdownMenu.Portal>
<DropdownMenu.SubContent />
</DropdownMenu.Portal>
</DropdownMenu.Sub>
<DropdownMenu.Separator />
<DropdownMenu.Arrow />
</DropdownMenu.Content>
</DropdownMenu.Portal>
</DropdownMenu.Root>
);
Contains all the parts of a dropdown menu.
| Prop | Type | Default |
| --- | --- | --- |
| defaultOpen<br><br>Prop description | boolean | No default value |
| open<br><br>Prop description | boolean | No default value |
| onOpenChange<br><br>Prop description | function<br><br>See full type | No default value |
| modal<br><br>Prop description | boolean | true |
| dir<br><br>Prop description | enum<br><br>See full type | No default value |
The button that toggles the dropdown menu. By default, the DropdownMenu.Content will position itself against the trigger.
| Prop | Type | Default |
| --- | --- | --- |
| asChild<br><br>Prop description | boolean | false |
| Data attribute | Values |
| --- | --- |
| [data-state] | "open" \| "closed" |
| [data-disabled] | Present when disabled |
When used, portals the content part into the body.
| Prop | Type | Default |
| --- | --- | --- |
| forceMount<br><br>Prop description | boolean | No default value |
| container<br><br>Prop description | HTMLElement | document.body |
The component that pops out when the dropdown menu is open.
| Prop | Type | Default |
| --- | --- | --- |
| asChild<br><br>Prop description | boolean | false |
| loop<br><br>Prop description | boolean | false |
| onCloseAutoFocus<br><br>Prop description | function<br><br>See full type | No default value |
| onEscapeKeyDown<br><br>Prop description | function<br><br>See full type | No default value |
| onPointerDownOutside<br><br>Prop description | function<br><br>See full type | No default value |
| onFocusOutside<br><br>Prop description | function<br><br>See full type | No default value |
| onInteractOutside<br><br>Prop description | function<br><br>See full type | No default value |
| forceMount<br><br>Prop description | boolean | No default value |
| side<br><br>Prop description | enum<br><br>See full type | "bottom" |
| sideOffset<br><br>Prop description | number | 0 |
| align<br><br>Prop description | enum<br><br>See full type | "center" |
| alignOffset<br><br>Prop description | number | 0 |
| avoidCollisions<br><br>Prop description | boolean | true |
| collisionBoundary<br><br>Prop description | Boundary<br><br>See full type | [] |
| collisionPadding<br><br>Prop description | number \| Padding<br><br>See full type | 0 |
| arrowPadding<br><br>Prop description | number | 0 |
| sticky<br><br>Prop description | enum<br><br>See full type | "partial" |
| hideWhenDetached<br><br>Prop description | boolean | false |
| Data attribute | Values |
| --- | --- |
| [data-state] | "open" \| "closed" |
| [data-side] | "left" \| "right" \| "bottom" \| "top" |
| [data-align] | "start" \| "end" \| "center" |
| [data-orientation] | "vertical" \| "horizontal" |
| CSS Variable | Description |
| --- | --- |
| --radix-dropdown-menu-content-transform-origin | The transform-origin computed from the content and arrow positions/offsets |
| --radix-dropdown-menu-content-available-width | The remaining width between the trigger and the boundary edge |
| --radix-dropdown-menu-content-available-height | The remaining height between the trigger and the boundary edge |
| --radix-dropdown-menu-trigger-width | The width of the trigger |
| --radix-dropdown-menu-trigger-height | The height of the trigger |
An optional arrow element to render alongside the dropdown menu. This can be used to help visually link the trigger with the DropdownMenu.Content. Must be rendered inside DropdownMenu.Content.
| Prop | Type | Default |
| --- | --- | --- |
| asChild<br><br>Prop description | boolean | false |
| width<br><br>Prop description | number | 10 |
| height<br><br>Prop description | number | 5 |
The component that contains the dropdown menu items.
| Prop | Type | Default |
| --- | --- | --- |
| asChild<br><br>Prop description | boolean | false |
| disabled<br><br>Prop description | boolean | No default value |
| onSelect<br><br>Prop description | function<br><br>See full type | No default value |
| textValue<br><br>Prop description | string | No default value |
| Data attribute | Values |
| --- | --- |
| [data-orientation] | "vertical" \| "horizontal" |
| [data-highlighted] | Present when highlighted |
| [data-disabled] | Present when disabled |
Used to group multiple DropdownMenu.Items.
| Prop | Type | Default |
| --- | --- | --- |
| asChild<br><br>Prop description | boolean | false |
Used to render a label. It won't be focusable using arrow keys.
| Prop | Type | Default |
| --- | --- | --- |
| asChild<br><br>Prop description | boolean | false |
An item that can be controlled and rendered like a checkbox.
| Prop | Type | Default |
| --- | --- | --- |
| asChild<br><br>Prop description | boolean | false |
| checked<br><br>Prop description | boolean \| 'indeterminate' | No default value |
| onCheckedChange<br><br>Prop description | function<br><br>See full type | No default value |
| disabled<br><br>Prop description | boolean | No default value |
| onSelect<br><br>Prop description | function<br><br>See full type | No default value |
| textValue<br><br>Prop description | string | No default value |
| Data attribute | Values |
| --- | --- |
| [data-state] | "checked" \| "unchecked" \| "indeterminate" |
| [data-highlighted] | Present when highlighted |
| [data-disabled] | Present when disabled |
Used to group multiple DropdownMenu.RadioItems.
| Prop | Type | Default |
| --- | --- | --- |
| asChild<br><br>Prop description | boolean | false |
| value<br><br>Prop description | string | No default value |
| onValueChange<br><br>Prop description | function<br><br>See full type | No default value |
An item that can be controlled and rendered like a radio.
| Prop | Type | Default |
| --- | --- | --- |
| asChild<br><br>Prop description | boolean | false |
| value*<br><br>Prop description | string | No default value |
| disabled<br><br>Prop description | boolean | No default value |
| onSelect<br><br>Prop description | function<br><br>See full type | No default value |
| textValue<br><br>Prop description | string | No default value |
| Data attribute | Values |
| --- | --- |
| [data-state] | "checked" \| "unchecked" \| "indeterminate" |
| [data-highlighted] | Present when highlighted |
| [data-disabled] | Present when disabled |
Renders when the parent DropdownMenu.CheckboxItem or DropdownMenu.RadioItem is checked. You can style this element directly, or you can use it as a wrapper to put an icon into, or both.
| Prop | Type | Default |
| --- | --- | --- |
| asChild<br><br>Prop description | boolean | false |
| forceMount<br><br>Prop description | boolean | No default value |
| Data attribute | Values |
| --- | --- |
| [data-state] | "checked" \| "unchecked" \| "indeterminate" |
Used to visually separate items in the dropdown menu.
| Prop | Type | Default |
| --- | --- | --- |
| asChild<br><br>Prop description | boolean | false |
Contains all the parts of a submenu.
| Prop | Type | Default |
| --- | --- | --- |
| defaultOpen<br><br>Prop description | boolean | No default value |
| open<br><br>Prop description | boolean | No default value |
| onOpenChange<br><br>Prop description | function<br><br>See full type | No default value |
An item that opens a submenu. Must be rendered inside DropdownMenu.Sub.
| Prop | Type | Default |
| --- | --- | --- |
| asChild<br><br>Prop description | boolean | false |
| disabled<br><br>Prop description | boolean | No default value |
| textValue<br><br>Prop description | string | No default value |
| Data attribute | Values |
| --- | --- |
| [data-state] | "open" \| "closed" |
| [data-highlighted] | Present when highlighted |
| [data-disabled] | Present when disabled |
| CSS Variable | Description |
| --- | --- |
| --radix-dropdown-menu-content-transform-origin | The transform-origin computed from the content and arrow positions/offsets |
| --radix-dropdown-menu-content-available-width | The remaining width between the trigger and the boundary edge |
| --radix-dropdown-menu-content-available-height | The remaining height between the trigger and the boundary edge |
| --radix-dropdown-menu-trigger-width | The width of the trigger |
| --radix-dropdown-menu-trigger-height | The height of the trigger |
The component that pops out when a submenu is open. Must be rendered inside DropdownMenu.Sub.
| Prop | Type | Default |
| --- | --- | --- |
| asChild<br><br>Prop description | boolean | false |
| loop<br><br>Prop description | boolean | false |
| onEscapeKeyDown<br><br>Prop description | function<br><br>See full type | No default value |
| onPointerDownOutside<br><br>Prop description | function<br><br>See full type | No default value |
| onFocusOutside<br><br>Prop description | function<br><br>See full type | No default value |
| onInteractOutside<br><br>Prop description | function<br><br>See full type | No default value |
| forceMount<br><br>Prop description | boolean | No default value |
| sideOffset<br><br>Prop description | number | 0 |
| alignOffset<br><br>Prop description | number | 0 |
| avoidCollisions<br><br>Prop description | boolean | true |
| collisionBoundary<br><br>Prop description | Boundary<br><br>See full type | [] |
| collisionPadding<br><br>Prop description | number \| Padding<br><br>See full type | 0 |
| arrowPadding<br><br>Prop description | number | 0 |
| sticky<br><br>Prop description | enum<br><br>See full type | "partial" |
| hideWhenDetached<br><br>Prop description | boolean | false |
| Data attribute | Values |
| --- | --- |
| [data-state] | "open" \| "closed" |
| [data-side] | "left" \| "right" \| "bottom" \| "top" |
| [data-align] | "start" \| "end" \| "center" |
| [data-orientation] | "vertical" \| "horizontal" |
You can create submenus by using DropdownMenu.Sub in combination with its parts.
<DropdownMenu.Root>
<DropdownMenu.Trigger>ā¦</DropdownMenu.Trigger>
<DropdownMenu.Portal>
<DropdownMenu.Content>
<DropdownMenu.Item>ā¦</DropdownMenu.Item>
<DropdownMenu.Item>ā¦</DropdownMenu.Item>
<DropdownMenu.Separator />
<DropdownMenu.Sub>
<DropdownMenu.SubTrigger>Sub menu ā</DropdownMenu.SubTrigger>
<DropdownMenu.Portal>
<DropdownMenu.SubContent>
<DropdownMenu.Item>Sub menu item</DropdownMenu.Item>
<DropdownMenu.Item>Sub menu item</DropdownMenu.Item>
<DropdownMenu.Arrow />
</DropdownMenu.SubContent>
</DropdownMenu.Portal>
</DropdownMenu.Sub>
<DropdownMenu.Separator />
<DropdownMenu.Item>ā¦</DropdownMenu.Item>
</DropdownMenu.Content>
</DropdownMenu.Portal>
</DropdownMenu.Root>
You can add special styles to disabled items via the data-disabled attribute.
// index.jsx
import { DropdownMenu } from "radix-ui";
import "./styles.css";
export default () => (
<DropdownMenu.Root>
<DropdownMenu.Trigger>ā¦</DropdownMenu.Trigger>
<DropdownMenu.Portal>
<DropdownMenu.Content>
<DropdownMenu.Item className="DropdownMenuItem" disabled>
ā¦
</DropdownMenu.Item>
<DropdownMenu.Item className="DropdownMenuItem">ā¦</DropdownMenu.Item>
</DropdownMenu.Content>
</DropdownMenu.Portal>
</DropdownMenu.Root>
);
/* styles.css */
.DropdownMenuItem[data-disabled] {
color: gainsboro;
}
Use the Separator part to add a separator between items.
<DropdownMenu.Root>
<DropdownMenu.Trigger>ā¦</DropdownMenu.Trigger>
<DropdownMenu.Portal>
<DropdownMenu.Content>
<DropdownMenu.Item>ā¦</DropdownMenu.Item>
<DropdownMenu.Separator />
<DropdownMenu.Item>ā¦</DropdownMenu.Item>
<DropdownMenu.Separator />
<DropdownMenu.Item>ā¦</DropdownMenu.Item>
</DropdownMenu.Content>
</DropdownMenu.Portal>
</DropdownMenu.Root>
Use the Label part to help label a section.
<DropdownMenu.Root>
<DropdownMenu.Trigger>ā¦</DropdownMenu.Trigger>
<DropdownMenu.Portal>
<DropdownMenu.Content>
<DropdownMenu.Label>Label</DropdownMenu.Label>
<DropdownMenu.Item>ā¦</DropdownMenu.Item>
<DropdownMenu.Item>ā¦</DropdownMenu.Item>
<DropdownMenu.Item>ā¦</DropdownMenu.Item>
</DropdownMenu.Content>
</DropdownMenu.Portal>
</DropdownMenu.Root>
Use the CheckboxItem part to add an item that can be checked.
import * as React from "react";
import { CheckIcon } from "@radix-ui/react-icons";
import { DropdownMenu } from "radix-ui";
export default () => {
const [checked, setChecked] = React.useState(true);
return (
<DropdownMenu.Root>
<DropdownMenu.Trigger>ā¦</DropdownMenu.Trigger>
<DropdownMenu.Portal>
<DropdownMenu.Content>
<DropdownMenu.Item>ā¦</DropdownMenu.Item>
<DropdownMenu.Item>ā¦</DropdownMenu.Item>
<DropdownMenu.Separator />
<DropdownMenu.CheckboxItem
checked={checked}
onCheckedChange={setChecked}
>
<DropdownMenu.ItemIndicator>
<CheckIcon />
</DropdownMenu.ItemIndicator>
Checkbox item
</DropdownMenu.CheckboxItem>
</DropdownMenu.Content>
</DropdownMenu.Portal>
</DropdownMenu.Root>
);
};
Use the RadioGroup and RadioItem parts to add an item that can be checked amongst others.
import * as React from "react";
import { CheckIcon } from "@radix-ui/react-icons";
import { DropdownMenu } from "radix-ui";
export default () => {
const [color, setColor] = React.useState("blue");
return (
<DropdownMenu.Root>
<DropdownMenu.Trigger>ā¦</DropdownMenu.Trigger>
<DropdownMenu.Portal>
<DropdownMenu.Content>
<DropdownMenu.RadioGroup value={color} onValueChange={setColor}>
<DropdownMenu.RadioItem value="red">
<DropdownMenu.ItemIndicator>
<CheckIcon />
</DropdownMenu.ItemIndicator>
Red
</DropdownMenu.RadioItem>
<DropdownMenu.RadioItem value="blue">
<DropdownMenu.ItemIndicator>
<CheckIcon />
</DropdownMenu.ItemIndicator>
Blue
</DropdownMenu.RadioItem>
<DropdownMenu.RadioItem value="green">
<DropdownMenu.ItemIndicator>
<CheckIcon />
</DropdownMenu.ItemIndicator>
Green
</DropdownMenu.RadioItem>
</DropdownMenu.RadioGroup>
</DropdownMenu.Content>
</DropdownMenu.Portal>
</DropdownMenu.Root>
);
};
You can add extra decorative elements in the Item parts, such as images.
import { DropdownMenu } from "radix-ui";
export default () => (
<DropdownMenu.Root>
<DropdownMenu.Trigger>ā¦</DropdownMenu.Trigger>
<DropdownMenu.Portal>
<DropdownMenu.Content>
<DropdownMenu.Item>
<img src="ā¦" />
Adolfo Hess
</DropdownMenu.Item>
<DropdownMenu.Item>
<img src="ā¦" />
Miyah Myles
</DropdownMenu.Item>
</DropdownMenu.Content>
</DropdownMenu.Portal>
</DropdownMenu.Root>
);
You may want to constrain the width of the content (or sub-content) so that it matches the trigger (or sub-trigger) width. You may also want to constrain its height to not exceed the viewport.
We expose several CSS custom properties such as --radix-dropdown-menu-trigger-width and --radix-dropdown-menu-content-available-height to support this. Use them to constrain the content dimensions.
// index.jsx
import { DropdownMenu } from "radix-ui";
import "./styles.css";
export default () => (
<DropdownMenu.Root>
<DropdownMenu.Trigger>ā¦</DropdownMenu.Trigger>
<DropdownMenu.Portal>
<DropdownMenu.Content className="DropdownMenuContent" sideOffset={5}>
ā¦
</DropdownMenu.Content>
</DropdownMenu.Portal>
</DropdownMenu.Root>
);
/* styles.css */
.DropdownMenuContent {
width: var(--radix-dropdown-menu-trigger-width);
max-height: var(--radix-dropdown-menu-content-available-height);
}
We expose a CSS custom property --radix-dropdown-menu-content-transform-origin. Use it to animate the content from its computed origin based on side, sideOffset, align, alignOffset and any collisions.
// index.jsx
import { DropdownMenu } from "radix-ui";
import "./styles.css";
export default () => (
<DropdownMenu.Root>
<DropdownMenu.Trigger>ā¦</DropdownMenu.Trigger>
<DropdownMenu.Portal>
<DropdownMenu.Content className="DropdownMenuContent">
ā¦
</DropdownMenu.Content>
</DropdownMenu.Portal>
</DropdownMenu.Root>
);
/* styles.css */
.DropdownMenuContent {
transform-origin: var(--radix-dropdown-menu-content-transform-origin);
animation: scaleIn 0.5s ease-out;
}
@keyframes scaleIn {
from {
opacity: 0;
transform: scale(0);
}
to {
opacity: 1;
transform: scale(1);
}
}
We expose data-side and data-align attributes. Their values will change at runtime to reflect collisions. Use them to create collision and direction-aware animations.
// index.jsx
import { DropdownMenu } from "radix-ui";
import "./styles.css";
export default () => (
<DropdownMenu.Root>
<DropdownMenu.Trigger>ā¦</DropdownMenu.Trigger>
<DropdownMenu.Portal>
<DropdownMenu.Content className="DropdownMenuContent">
ā¦
</DropdownMenu.Content>
</DropdownMenu.Portal>
</DropdownMenu.Root>
);
/* styles.css */
.DropdownMenuContent {
animation-duration: 0.6s;
animation-timing-function: cubic-bezier(0.16, 1, 0.3, 1);
}
.DropdownMenuContent[data-side="top"] {
animation-name: slideUp;
}
.DropdownMenuContent[data-side="bottom"] {
animation-name: slideDown;
}
@keyframes slideUp {
from {
opacity: 0;
transform: translateY(10px);
}
to {
opacity: 1;
transform: translateY(0);
}
}
@keyframes slideDown {
from {
opacity: 0;
transform: translateY(-10px);
}
to {
opacity: 1;
transform: translateY(0);
}
}
Adheres to the Menu Button WAI-ARIA design pattern and uses roving tabindex to manage focus movement among menu items.
| Key | Description |
| --- | --- |
| Space | When focus is on DropdownMenu.Trigger, opens the dropdown menu and focuses the first item. <br>When focus is on an item, activates the focused item. |
| Enter | When focus is on DropdownMenu.Trigger, opens the dropdown menu and focuses the first item. <br>When focus is on an item, activates the focused item. |
| ArrowDown | When focus is on DropdownMenu.Trigger, opens the dropdown menu. <br>When focus is on an item, moves focus to the next item. |
| ArrowUp | When focus is on an item, moves focus to the previous item. |
| ArrowRightArrowLeft | When focus is on DropdownMenu.SubTrigger, opens or closes the submenu depending on reading direction. |
| Esc | Closes the dropdown menu and moves focus to DropdownMenu.Trigger. |
Create your own API by abstracting the primitive parts into your own component.
This example abstracts the DropdownMenu.Arrow and DropdownMenu.ItemIndicator parts. It also wraps implementation details for CheckboxItem and RadioItem.
import {
DropdownMenu,
DropdownMenuTrigger,
DropdownMenuContent,
DropdownMenuLabel,
DropdownMenuItem,
DropdownMenuGroup,
DropdownMenuCheckboxItem,
DropdownMenuRadioGroup,
DropdownMenuRadioItem,
DropdownMenuSeparator,
} from "./your-dropdown-menu";
export default () => (
<DropdownMenu>
<DropdownMenuTrigger>DropdownMenu trigger</DropdownMenuTrigger>
<DropdownMenuContent>
<DropdownMenuItem>Item</DropdownMenuItem>
<DropdownMenuLabel>Label</DropdownMenuLabel>
<DropdownMenuGroup>Group</DropdownMenuGroup>
<DropdownMenuCheckboxItem>CheckboxItem</DropdownMenuCheckboxItem>
<DropdownMenuSeparator>Separator</DropdownMenuSeparator>
<DropdownMenuRadioGroup>
<DropdownMenuRadioItem>RadioItem</DropdownMenuRadioItem>
<DropdownMenuRadioItem>RadioItem</DropdownMenuRadioItem>
</DropdownMenuRadioGroup>
</DropdownMenuContent>
</DropdownMenu>
);
// your-dropdown-menu.jsx
import * as React from "react";
import { DropdownMenu as DropdownMenuPrimitive } from "radix-ui";
import { CheckIcon, DividerHorizontalIcon } from "@radix-ui/react-icons";
export const DropdownMenu = DropdownMenuPrimitive.Root;
export const DropdownMenuTrigger = DropdownMenuPrimitive.Trigger;
export const DropdownMenuContent = React.forwardRef(
({ children, ...props }, forwardedRef) => {
return (
<DropdownMenuPrimitive.Portal>
<DropdownMenuPrimitive.Content {...props} ref={forwardedRef}>
{children}
<DropdownMenuPrimitive.Arrow />
</DropdownMenuPrimitive.Content>
</DropdownMenuPrimitive.Portal>
);
},
);
export const DropdownMenuLabel = DropdownMenuPrimitive.Label;
export const DropdownMenuItem = DropdownMenuPrimitive.Item;
export const DropdownMenuGroup = DropdownMenuPrimitive.Group;
export const DropdownMenuCheckboxItem = React.forwardRef(
({ children, ...props }, forwardedRef) => {
return (
<DropdownMenuPrimitive.CheckboxItem {...props} ref={forwardedRef}>
{children}
<DropdownMenuPrimitive.ItemIndicator>
{props.checked === "indeterminate" && <DividerHorizontalIcon />}
{props.checked === true && <CheckIcon />}
</DropdownMenuPrimitive.ItemIndicator>
</DropdownMenuPrimitive.CheckboxItem>
);
},
);
export const DropdownMenuRadioGroup = DropdownMenuPrimitive.RadioGroup;
export const DropdownMenuRadioItem = React.forwardRef(
({ children, ...props }, forwardedRef) => {
return (
<DropdownMenuPrimitive.RadioItem {...props} ref={forwardedRef}>
{children}
<DropdownMenuPrimitive.ItemIndicator>
<CheckIcon />
</DropdownMenuPrimitive.ItemIndicator>
</DropdownMenuPrimitive.RadioItem>
);
},
);
export const DropdownMenuSeparator = DropdownMenuPrimitive.Separator;
PreviousDialog
NextForm