Skip to main content

Dropdown

A <select> element with a label. List options as Markdown list items (- item) as children.

Basic usage

dropdown: Select role
- Admin
- Editor
- Viewer

Option prefixes

Each option line can start with a special prefix (after the - ):

full dropdown: Status
- placeholder Choose status...
- Active
- selected Inactive
- disabled Archived
PrefixEffect
placeholder or placeholder TextShown as a disabled, pre-selected placeholder.
selected TextPre-selected option.
disabled TextGreyed-out, unselectable option.

Full width

full dropdown: Country
- placeholder Select a country...
- United States
- Romania
- Germany

Disabled state

disabled dropdown: Region
- North
- South

Radiogroup & Radio

For mutually exclusive choices that must all be visible at once, use radiogroup: with radio: children:

radiogroup: Account type
checked radio: Individual
radio: Team
radio: Enterprise

Each radio in the same radiogroup shares a name, making them mutually exclusive. Use checked on one to pre-select it, disabled to disable one.