Dropdown
Dropdown menu with new DropdownTrigger, DropdownContent, and DropdownItem subcomponents.
v0.3.0 adds DropdownTrigger, DropdownContent, and DropdownItem subcomponents. DropdownItem automatically closes the menu after clicking. The old Trigger render fragment + IsOpen binding API is still supported.
Dropdowns close on Escape from 0.3.3.
What changed from v0.2.x
| v0.2.1 | v0.3.0 |
|---|---|
<Trigger> render fragment + IsOpen binding |
<DropdownTrigger> subcomponent, no external state |
| Manual close on item click | DropdownItem auto-closes parent on click |
Installation
bash
shellui add dropdown
dropdown-trigger, dropdown-content, and dropdown-item are auto-installed as dependencies.
Usage
Compositional (recommended)
<Dropdown>
<DropdownTrigger>
<Button Variant="ButtonVariant.Outline">Options</Button>
</DropdownTrigger>
<DropdownContent>
<DropdownItem>Profile</DropdownItem>
<DropdownItem>Settings</DropdownItem>
<Separator />
<DropdownItem><span class="text-destructive">Log out</span></DropdownItem>
</DropdownContent>
</Dropdown>
With click handlers
Actions
<Dropdown>
<DropdownTrigger>Actions</DropdownTrigger>
<DropdownContent>
<DropdownItem OnClick="HandleEdit">Edit</DropdownItem>
<DropdownItem OnClick="HandleDuplicate">Duplicate</DropdownItem>
<Separator />
<DropdownItem OnClick="HandleDelete" Class="text-destructive">Delete</DropdownItem>
</DropdownContent>
</Dropdown>
@code {
private void HandleEdit() { }
private void HandleDuplicate() { }
private void HandleDelete() { }
}
User menu
Disabled item
Menu
<Dropdown>
<DropdownTrigger>Menu</DropdownTrigger>
<DropdownContent>
<DropdownItem>Available</DropdownItem>
<DropdownItem Disabled="true">Unavailable</DropdownItem>
</DropdownContent>
</Dropdown>
Legacy (also supported)
The v0.2.x <Trigger> + <ChildContent> pattern with external @bind-IsOpen still works:
<Dropdown @bind-IsOpen="isOpen">
<Trigger>
<span>Open Menu</span>
</Trigger>
<ChildContent>
<button class="relative flex w-full cursor-default select-none items-center rounded-sm px-2 py-1.5 text-sm outline-none hover:bg-accent">
Profile
</button>
<button class="relative flex w-full cursor-default select-none items-center rounded-sm px-2 py-1.5 text-sm outline-none hover:bg-accent">
Settings
</button>
</ChildContent>
</Dropdown>
@code {
private bool isOpen = false;
}
API Reference
<Dropdown>
| Parameter | Type | Default | Description |
|---|---|---|---|
ChildContent |
RenderFragment |
— | DropdownTrigger + DropdownContent |
<DropdownTrigger>
| Parameter | Type | Default | Description |
|---|---|---|---|
ChildContent |
RenderFragment |
— | Trigger button content |
<DropdownContent>
| Parameter | Type | Default | Description |
|---|---|---|---|
ChildContent |
RenderFragment |
— | DropdownItem list |
<DropdownItem>
| Parameter | Type | Default | Description |
|---|---|---|---|
ChildContent |
RenderFragment |
— | Item label |
Disabled |
bool |
false |
Prevents selection |
OnClick |
EventCallback |
— | Callback — menu closes automatically after firing |
Class |
string? |
null |
Additional CSS classes |