shadcn.io is an independent project built on shadcn/ui
The dashed area reads Right click here. Sort Ascending and Sort Descending come first, each with an arrow icon. Clear Sort follows on its own.
Use it on a column header for the smallest sort menu. A clickable header, or a Dropdown Menu there, helps people who never right-click. In React, Ark UI does not sort the table.
Installation
Anatomy
Usage
<ContextMenu>
<ContextMenuTrigger className="flex h-[200px] w-full max-w-lg items-center justify-center rounded-md border border-dashed text-sm">
<span className="pointer-fine:inline-block hidden">Right click here</span>
<span className="pointer-coarse:inline-block hidden">
Long press here
</span>
</ContextMenuTrigger>
<ContextMenuContent className="w-56">
<ContextMenuGroup>
<ContextMenuItem value="sort-ascending">
<ArrowUpIcon aria-hidden="true" />
Sort Ascending
</ContextMenuItem>
<ContextMenuItem value="sort-descending">
<ArrowDownIcon aria-hidden="true" />
Sort Descending
</ContextMenuItem>
</ContextMenuGroup>
<ContextMenuSeparator />
<ContextMenuGroup>
<ContextMenuItem value="clear-sort">Clear Sort</ContextMenuItem>
</ContextMenuGroup>
</ContextMenuContent>
</ContextMenu>FAQ
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.
How do I show the current sort?
Make the three a radio group, as the radio items example does, so the current direction is checked.
API Reference
Context Menu
Sets value="sort-ascending", value="sort-descending" and value="clear-sort". The rest is on the Context Menu page.
