Radio
Bootstrap 5 Radio component
A Radio Button is a component used to allow a user to make a single choice among a number of options (whereas Checkboxes are used for selecting multiple options).
Basic example
Browser default checkboxes and radios are replaced with the help of
.form-check
, a series of classes for both input types that improves the layout
and behavior of their HTML elements, that provide greater customization and cross browser
consistency. Checkboxes are for selecting one or several options in a list, while radios are
for selecting one option from many.
Structurally, our <input>
s and <label>
s are sibling
elements as opposed to an <input>
within a <label>
. This
is slightly more verbose as you must specify id
and for
attributes
to relate the <input>
and <label>
.
We use the sibling selector (~
) for all our
<input>
states, like :checked
or :disabled
. When
combined with the .form-check-label
class, we can easily style the text for each
item based on the <input>
's state.
<!-- Default radio -->
<div class="form-check">
<input class="form-check-input" type="radio" name="flexRadioDefault" id="flexRadioDefault1"/>
<label class="form-check-label" for="flexRadioDefault1"> Default radio </label>
</div>
<!-- Default checked radio -->
<div class="form-check">
<input class="form-check-input" type="radio" name="flexRadioDefault" id="flexRadioDefault2" checked/>
<label class="form-check-label" for="flexRadioDefault2"> Default checked radio </label>
</div>
Disabled
Add the disabled
attribute and the associated <label>
s are
automatically styled to match with a lighter color to help indicate the input’s state.
<div class="form-check">
<input class="form-check-input" type="radio" name="flexRadioDisabled" id="flexRadioDisabled" disabled />
<label class="form-check-label" for="flexRadioDisabled"> Disabled radio </label>
</div>
<div class="form-check">
<input class="form-check-input" type="radio" name="flexRadioDisabled" id="flexRadioCheckedDisabled" checked disabled/>
<label class="form-check-label" for="flexRadioCheckedDisabled">Disabled checked radio</label>
</div>
Inline
Group checkboxes or radios on the same horizontal row by adding
.form-check-inline
to any .form-check
.
<div class="form-check form-check-inline">
<input class="form-check-input" type="radio" name="inlineRadioOptions" id="inlineRadio1" value="option1" />
<label class="form-check-label" for="inlineRadio1">1</label>
</div>
<div class="form-check form-check-inline">
<input class="form-check-input" type="radio" name="inlineRadioOptions" id="inlineRadio2" value="option2" />
<label class="form-check-label" for="inlineRadio2">2</label>
</div>
<div class="form-check form-check-inline">
<input class="form-check-input" type="radio" name="inlineRadioOptions" id="inlineRadio3" value="option3" disabled />
<label class="form-check-label" for="inlineRadio3">3 (disabled)</label>
</div>
Without labels
Omit the wrapping .form-check
for checkboxes and radios that have no label text.
Remember to still provide some form of label for assistive technologies (for instance, using
aria-label
).
<div>
<input class="form-check-input" type="radio" name="radioNoLabel" id="radioNoLabel1" value="" aria-label="..." />
</div>
<div>
<input class="form-check-input" type="radio" name="radioNoLabel" id="radioNoLabel2" value="" aria-label="..." />
</div>