DropdownButton
A button whose click opens a dropdown menu of secondary actions, indicated by a chevron.
When to Use
- Expose a list of actions from a single trigger when there is no dominant primary action.
- Replace a row of overflow actions in toolbars or card headers.
- Provide contextual operations (edit, share, delete) without cluttering the surface.
API Reference
DropdownButton
| Property | Type | Default | Description |
|---|---|---|---|
| Text | string? | null | Button label text. Ignored when ChildContent is provided. |
| ChildContent | RenderFragment? | null | Custom button label content. Takes precedence over Text. |
| MenuContent | RenderFragment? | null | The dropdown menu items rendered inside the menu. Place DropdownMenuItem elements here. |
| Variant | Button.ButtonVariant | Default | Visual style of the button. Values: Default, Secondary, Destructive, Outline, Ghost, Link. |
| Size | Button.ButtonSize | Default | Size of the button. Values: Sm, Default, Lg. |
| Disabled | bool | false | Disables the button and prevents the menu from opening. |
| Class | string? | null | Additional CSS classes applied to the button. |
| AdditionalAttributes | Dictionary<string, object>? | null | Additional HTML attributes forwarded to the trigger element. |
Related Components
- Button — A standard single-action trigger.
- SplitButton — A split button with a separate main action and a dropdown chevron half.
- DropdownMenu — The underlying dropdown menu primitive used by DropdownButton.