1. Components
  2. radio

Radio

Single-choice form control for mutually exclusive options in a named group.

Demo

<div class="flex flex-col gap-3">
    <x-ui.radio name="radio_demo" id="def_radio_check" label="Default Radio(selected)" checked/>
    <x-ui.radio name="radio_demo" id="def_radio" label="Example 2"/>
</div>

Installation

Shell
php artisan flexi:add radio

Disabled

<div class="flex flex-col gap-3">
    <x-ui.radio disabled id="def_radio_check_demo" label="Default Radio(selected)" checked/>
    <x-ui.radio disabled id="def_radio_demo" label="Example 2"/>
</div>

Colors

Same tokens as the checkbox: the fill is --checkbox-checked-color , the dot is --checkbox-mark-color ; --radio-dot-size sets its size (37.5% by default).

<div class="flex flex-wrap items-center gap-6">
    <x-ui.radio id="rd-default" name="rd-colors-a" label="Default" checked />
    <x-ui.radio id="rd-light" name="rd-colors-b" label="Light dot" checked
        class="checked:bg-background checked:border-primary! [--checkbox-mark-color:var(--color-primary)] [--radio-dot-size:50%]" />
    <x-ui.radio id="rd-invalid" name="rd-colors-c" label="Required" invalid />
</div>

Best Practices

  • Keep option labels short and mutually exclusive.
  • Preselect a sensible default when possible.
  • Use a clear group label so the choice context is obvious.

API

Prop Description
id (string|null) Input id. Falls back to name if omitted.
name (string) Shared group name for mutually exclusive selection.
value (string) Submitted value for this option.
checked (boolean) Marks this option as selected by default.
disabled (boolean) Disables the radio option.
size (sm|md|lg) Controls control size.
invalid (boolean) Marks the radio invalid (data-invalid , aria-invalid ).
label (string) Optional inline label rendered with the radio.