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
| Prefix | Effect |
|---|---|
placeholder or placeholder Text | Shown as a disabled, pre-selected placeholder. |
selected Text | Pre-selected option. |
disabled Text | Greyed-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.