options | readonly TOption[] | [] | The choices, rendered as native <input type="radio">s. GogRadioOption ({ id, label, disabled? }) by default; any other shape through the three accessors below. |
optionLabel21.19.0 | string | ((o: TOption) => string) | 'label' | How an option turns into its visible text: a property path (dot-paths included, "place.city") or a function. |
optionValue21.19.0 | string | ((o: TOption) => string | number) | 'id' | What value holds for an option: a property path or a function. It must give a string or a number, as value does. |
optionDisabled21.19.0 | string | ((o: TOption) => boolean) | 'disabled' | Which options are disabled: a property path or a function. |
value | string | number | null | null | What optionValue gives for the selected option — its id by default. Two-way bindable with [(value)]. |
label | string | '' | The group’s own label, rendered above the options. |
ariaLabel | string | '' | Accessible name for the group, used when there is no visible label. |
name | string | auto-generated | The shared name attribute for the radios. Generated per instance unless you set it — it is what makes the browser enforce mutual exclusivity. |
orientation | 'vertical' | 'horizontal' | 'vertical' | How the options are laid out. |
size | 'xsm' | 'sm' | 'md' | 'lg' | 'slg' | GOG_CONFIG.control.size ?? 'md' | Circle and label scale. Reuses gog-checkbox’s size steps. |
disabled | boolean | false | Disables the whole group. Individual options carry their own optional disabled flag. |
errorMessage | string | '' | Validation message rendered under the group. |
errorDisplay | 'manual' | 'auto' | GOG_CONFIG.control.errorDisplay ?? 'manual' | manual shows errorMessage whenever it is set; auto derives it from the bound form control’s state. |
fullWidth | boolean | false | Stretches the group to fill its container. Horizontal, the options share the width in equal parts, each pressable across its whole part, and still wrap once the labels no longer fit; before 21.15.0 a full-width horizontal group stacked its options. |