Radio
A single-choice radio group, for a small set of mutually exclusive options.


Reach for it when you need:
- Mode selection
- A single-choice field inside a Form
Component name: Radio · Category: Input
In the palette: Single-choice radio group
Properties
Any property can be bound to a tag, another component's property, or a query.
| Property | Type | Default | Description |
|---|---|---|---|
value | string | "" | The chosen option's value — reflects the selection, and bindable. |
options | array | [{"label":"Option 1","value":"1"},{"label":"Option 2","value… (truncated) | The choices. |
optionsLayout | enum | vertical | Stack the options vertically, or lay them out in a horizontal row. Options: vertical · horizontal. |
title | string | Radio | — |
showTitle | boolean | true | — |
titleSize | number | 13 | — |
disabled | boolean | false | — |
style | style | {} | Custom CSS properties |
Events
Attach event actions to these in the Event Manager.
| Event | Label | Group | Payload |
|---|---|---|---|
click | Click | Mouse | The DOM event. |
dblclick | Double click | Mouse | The DOM event. |
contextmenu | Right click | Mouse | The DOM event. |
mouseenter | Mouse enter | Mouse | The DOM event. |
mouseleave | Mouse leave | Mouse | The DOM event. |
change | Change | Input | The DOM event. |
submit | Submit | Input | The DOM event. |
focus | Focus | Input | The DOM event. |
blur | Blur | Input | The DOM event. |
Right-click behaves differently in the Designer
contextmenu fires your configured actions at runtime only — in LiveView and in preview. On the Designer canvas the right-click is captured to open the Event Manager, so testing it there will not run your actions. Test right-click in preview.
Notes
Beyond about five options, a Dropdown reads better and takes less space.