Components

Radio

{note} You're browsing the documentation for an old version of laravel-form-components. Consider upgrading your project to v7. Check your version with the following command:

composer show rawilk/laravel-form-components

The radio component offers an easy way to set up a radio input field in your forms. By simple setting its name attribute it also automatically sets your id attribute and makes sure old values are respected.

The most basic usage of the component exists in setting a name attribute:

<x-radio name="tier" id="tier_1" value="tier_1" />
<x-radio name="tier" id="tier_2" value="tier_2" />

This will output:

<div class="choice-container">
    <div class="choice-input">
        <input class="form-radio"
               name="tier"
               id="tier_1"
               type="radio"
               value="tier_1" 
        />
    </div>

    <div class="choice-label">
        <label for="tier_1"></label>
    </div>
</div>
<div class="choice-container">
    <div class="choice-input">
        <input class="form-radio"
               name="tier"
               id="tier_2"
               type="radio"
               value="tier_2" 
        />
    </div>

    <div class="choice-label">
        <label for="tier_2"></label>
    </div>
</div>

You can easily add a label to a radio by using the label attribute, or by using the default slot:

Via prop:

<x-radio name="tier" id="tier_1" value="tier_1" label="Tier 1" />
<x-radio name="tier" id="tier_2" value="tier_2" label="Tier 2" />

Via slot:

<x-radio name="tier" id="tier_1" value="tier_1">
    Tier 1
</x-radio>
<x-radio name="tier" id="tier_2" value="tier_2">
    Tier 2
</x-radio>

Both will output:

<div class="choice-container">
    <div class="choice-input">
        <input class="form-radio"
               name="tier"
               id="tier_1"
               type="radio"
               value="tier_1" 
        />
    </div>

    <div class="choice-label">
        <label for="tier_1">Tier 1</label>
    </div>
</div>
<div class="choice-container">
    <div class="choice-input">
        <input class="form-radio"
               name="tier"
               id="tier_2"
               type="radio"
               value="tier_2" 
        />
    </div>

    <div class="choice-label">
        <label for="tier_2">Tier 2</label>
    </div>
</div>

You can also add a description (help text) for a radio by either setting the description attribute or by using the description slot.

Via prop:

<x-radio name="tier" id="tier_1" value="tier_1" label="Tier 1" description="Our most basic tier" />
<x-checkbox name="tier" id="tier_1" value="tier_1" label="Tier 1">
    <x-slot name="description">Our most basic tier</x-slot>
</x-checkbox>

Both will output:

<div class="choice-container">
    <div class="choice-input">
        <input class="form-radio"
               name="tier"
               id="tier_1"
               type="radio"
               value="tier_1" 
        />
    </div>

    <div class="choice-label">
        <label for="tier_1">Tier 1</label>
    
        <p class="choice-description">Our most basic tier</p>
    </div>
</div>

The radio component also supports checked values that were set. For example, you might want to apply some validation in the backend and make sure the user doesn't lose their input data when you show them the form again with the validation errors. When re-rendering the form, the radio component will remember the checked value (when not using wire:model):

<input name="tier" id="tier_1" value="tier_1" type="radio" checked />
Previous
Checkbox
Caught a mistake? Suggest an edit on GitHub