Field radio

Version: Free.

Why this type

Every choice is visible. You do not open a dropdown. The options list is the same as select. It fits two to five choices when only one can be picked.

When to use

• Alignment left / center / right
• Background type image / color / video
• Small labeled choice sets

Tips

Long lists belong in select. Simple on/off is faster with yesno or toggle.

Similar types

• select for long static lists
• checkboxgroup for multiple flags

Schema

{
  "name": "align",
  "type": "radio",
  "label": "Alignment",
  "options": [
    {
      "label": "Left",
      "value": "left"
    },
    {
      "label": "Center",
      "value": "center"
    }
  ],
  "tab": "Content",
  "width": 100,
  "active": true
}

Value

Selected option value string.

Section data

Key align in the section data: selected option value string:

{
  "align": "lg"
}

Chunk example

modx

<div class="align-[[+align]]">
  …
</div>

fenom

<div class="align-{$align|escape}">
  …
</div>

Common properties

For fields with name that are stored in the section data:

Key	Type	Role	CMP
tab	string	Group subtitle in the inspector	yes
width	25–100	Field width as % of the row (flex)	yes
description	string	Hint under the label	yes
default	any	Initial value for a new section	yes
active	bool	false hides the field in the inspector	yes
required	bool	Required on publish (draft still saves)	yes

See fields overview.

See also

• Field types reference
• Fields overview