Context Menu

Right-click context menu using the new compositional ContextMenuTrigger and ContextMenuContent subcomponents.

ContextMenu shows a right-click menu for any element. In v0.3.0, shellui add context-menu also installs the compositional ContextMenuTrigger, ContextMenuContent and ContextMenuOption parts. Wrap any element — it will show a right-click floating menu. Menu items are passed as a List<ContextMenuItem> via the Items parameter. The wrapped ChildContent is the right-click target.

Installation

bash
shellui add context-menu

Usage

Basic

<ContextMenu Items="MenuItems" OnItemSelected="HandleItemSelected">
    <Button>Right-click me</Button>
</ContextMenu>

@if (lastSelected is not null)
{
    <p class="mt-2 text-sm text-muted-foreground">Selected: @lastSelected</p>
}

@code {
    private List<ContextMenuItem> MenuItems = new()
    {
        new ContextMenuItem { Label = "Edit", Shortcut = "Ctrl E" },
        new ContextMenuItem { Label = "Duplicate", Shortcut = "Ctrl D" },
        new ContextMenuItem { IsSeparator = true },
        new ContextMenuItem { Label = "Delete" },
    };

    private string? lastSelected;

    private void HandleItemSelected(ContextMenuItem item) => lastSelected = item.Label;
}

Any trigger element

Right-click anywhere in this area
<ContextMenu Items="MenuItems" OnItemSelected="HandleItemSelected">
    <div class="flex h-32 w-full items-center justify-center rounded-md border border-dashed text-sm text-muted-foreground">
        Right-click anywhere in this area
    </div>
</ContextMenu>

@code {
    private List<ContextMenuItem> MenuItems = new()
    {
        new ContextMenuItem { Label = "Edit", Shortcut = "Ctrl E" },
        new ContextMenuItem { Label = "Duplicate", Shortcut = "Ctrl D" },
        new ContextMenuItem { IsSeparator = true },
        new ContextMenuItem { Label = "Delete" },
    };

    private string? lastSelected;

    private void HandleItemSelected(ContextMenuItem item) => lastSelected = item.Label;
}

With icons

Right-click this card
<ContextMenu Items="MenuItems" OnItemSelected="HandleItemSelected">
    <div class="rounded-md border p-8 select-none">
        Right-click this card
    </div>
</ContextMenu>

@code {
    private List<ContextMenuItem> MenuItems = new()
    {
        new ContextMenuItem { Label = "Edit", Icon = "✏️", Shortcut = "Ctrl E" },
        new ContextMenuItem { Label = "Duplicate", Icon = "📄", Shortcut = "Ctrl D" },
        new ContextMenuItem { IsSeparator = true },
        new ContextMenuItem { Label = "Delete", Icon = "🗑️", Data = "delete" },
    };

    private void HandleItemSelected(ContextMenuItem item)
    {
        // item.Data carries any payload you attached
    }
}

API Reference

<ContextMenu>

Parameter Type Default Description
Items List<ContextMenuItem> — The list of menu items to display
OnItemSelected EventCallback<ContextMenuItem> — Called when the user clicks an item
ChildContent RenderFragment — The element that receives the right-click event

ContextMenuItem class

Property Type Description
Label string Displayed text
Icon string? Text or emoji rendered before the label (optional)
Shortcut string? Shortcut hint shown on the right (optional)
Disabled bool Shows the item but ignores clicks
IsSeparator bool Renders a divider instead of an item
Data object? Any payload; read it back from the item passed to OnItemSelected

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.