Skip to main content
Version: 1.0.4

Radio

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

The Radio component as it renders with its default settings.The Radio component as it renders with its default settings.

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.

PropertyTypeDefaultDescription
valuestring""The chosen option's value — reflects the selection, and bindable.
optionsarray[{"label":"Option 1","value":"1"},{"label":"Option 2","value… (truncated)The choices.
optionsLayoutenumverticalStack the options vertically, or lay them out in a horizontal row. Options: vertical · horizontal.
titlestringRadio
showTitlebooleantrue
titleSizenumber13
disabledbooleanfalse
stylestyle{}Custom CSS properties

Events

Attach event actions to these in the Event Manager.

EventLabelGroupPayload
clickClickMouseThe DOM event.
dblclickDouble clickMouseThe DOM event.
contextmenuRight clickMouseThe DOM event.
mouseenterMouse enterMouseThe DOM event.
mouseleaveMouse leaveMouseThe DOM event.
changeChangeInputThe DOM event.
submitSubmitInputThe DOM event.
focusFocusInputThe DOM event.
blurBlurInputThe 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.