shadcn.io is an independent project built on shadcn/ui
The dashed area reads Right click here. Invite User comes first. Share via Email lists Gmail, Outlook, and Yahoo Mail. Share via Message lists WhatsApp, Telegram, and Slack. More Options... is last.
Use submenus when one action has several targets and the top level should stay short. One nested level is usually enough. A Command menu scales better if the target list grows. In Svelte, Ark UI opens the submenu from its trigger.
Installation
Anatomy
Usage
<ContextMenu><ContextMenuTrigger class="flex h-[200px] w-full max-w-lg items-center justify-center rounded-md border border-dashed text-sm"><span class="pointer-fine:inline-block hidden">Right click here</span><span class="pointer-coarse:inline-block hidden">Long press here</span></ContextMenuTrigger><ContextMenuContent class="w-56"><ContextMenuGroup><ContextMenuItem value="invite-user"><UserPlusIcon aria-hidden="true" />Invite User</ContextMenuItem></ContextMenuGroup><ContextMenuSeparator /><ContextMenuSub><ContextMenuSubTrigger><MailIcon aria-hidden="true" />Share via Email</ContextMenuSubTrigger><ContextMenuSubContent class="w-48"><ContextMenuGroup><ContextMenuItem value="gmail"><MailIcon aria-hidden="true" />Gmail</ContextMenuItem><ContextMenuItem value="outlook"><MailIcon aria-hidden="true" />Outlook</ContextMenuItem><ContextMenuItem value="yahoo-mail"><MailIcon aria-hidden="true" />Yahoo Mail</ContextMenuItem></ContextMenuGroup></ContextMenuSubContent></ContextMenuSub><ContextMenuSub><ContextMenuSubTrigger><MessageSquareIcon aria-hidden="true" />Share via Message</ContextMenuSubTrigger><ContextMenuSubContent class="w-48"><ContextMenuGroup><ContextMenuItem value="whatsapp"><MessageSquareIcon aria-hidden="true" />WhatsApp</ContextMenuItem><ContextMenuItem value="telegram"><MessageSquareIcon aria-hidden="true" />Telegram</ContextMenuItem><ContextMenuItem value="slack"><MessageSquareIcon aria-hidden="true" />Slack</ContextMenuItem></ContextMenuGroup></ContextMenuSubContent></ContextMenuSub><ContextMenuSeparator /><ContextMenuGroup><ContextMenuItem value="more-options"><PlusIcon aria-hidden="true" />More Options...</ContextMenuItem></ContextMenuGroup></ContextMenuContent></ContextMenu>FAQ
How deep should submenus go?
One level, as here. Each extra level is another path for the pointer to lose; past that, open a dialog instead.
How are the icons added?
A Lucide icon as the first child of each item, hidden from assistive tech since the label names the action. The menu styles size and space it.
What opens the menu?
A right-click inside the dashed area, which reads Right click here on a mouse and Long press here on a touch screen.
The area is ContextMenuTrigger; a long press on it opens the menu too.
Wrap your own row, file or canvas in the trigger instead.
How do I run an action when an item is chosen?
Each item has a value; handle onSelect on ContextMenu, which receives { value }.
The menu closes after the action runs.
How do keyboard and touch users find these actions?
The arrow keys move through an open menu, Enter runs an item and Escape closes it. A right-click is easy to miss, so also offer the same actions from a visible button, such as a Dropdown Menu.
API Reference
Context Menu
Sets value="invite-user", value="gmail", value="outlook", value="yahoo-mail", value="whatsapp" and value="telegram". The rest is on the Context Menu page.
