extends ../../_layout/default.pug
block canonical
link(rel='canonical' href='https://coreui.io/docs/forms/checks-radios/')
block breadcrumb
+breadcrumb(
[
{ href: '#', label: 'Home'},
{ label: 'Components'},
{ label: 'Forms'},
'Checks & radios'
]
)
block js
| document.querySelectorAll('.form-example-indeterminate [type="checkbox"]').forEach(function (checkbox) {
| checkbox.indeterminate = true
| })
block view
+docs-components('https://coreui.io/docs/forms/checks-radios/')
.row
.col-12
.card.mb-4
.card-header
strong Checkbox
.card-body
+example('https://coreui.io/docs/forms/checks-radios/#checks')
.form-check
input.form-check-input#flexCheckDefault(type='checkbox')
label.form-check-label(for='flexCheckDefault') Default checkbox
.form-check
input.form-check-input#flexCheckChecked(type='checkbox' checked)
label.form-check-label(for='flexCheckChecked') Checked checkbox
.col-12
.card.mb-4
.card-header
strong Indeterminate
.card-body
p.text-body-secondary.small
| Checkboxes can utilize the
code :indeterminate
| pseudo class when manually set via JavaScript (there is no available HTML attribute for specifying it).
+example('https://coreui.io/docs/forms/checks-radios/#indeterminate')
.form-check.form-example-indeterminate
input.form-check-input#flexCheckIndeterminate(type='checkbox')
label.form-check-label(for='flexCheckIndeterminate') Indeterminate checkbox
.col-12
.card.mb-4
.card-header
strong Checkbox
span.small.ms-1 Disabled
.card-body
p.text-body-secondary.small
| Add the
code disabled
| attribute and the associated
code
= '<label>'
| s are automatically styled to match with a lighter color to help indicate the input’s state.
+example('https://coreui.io/docs/forms/checks-radios/#disabled')
.form-check
input.form-check-input#flexCheckDisabled(type='checkbox' disabled)
label.form-check-label(for='flexCheckDisabled') Disabled checkbox
.form-check
input.form-check-input#flexCheckCheckedDisabled(type='checkbox' checked disabled)
label.form-check-label(for='flexCheckCheckedDisabled') Disabled checked checkbox
.row
.col-12
.card.mb-4
.card-header
strong Radios
.card-body
+example('https://coreui.io/docs/forms/checks-radios/#radios')
.form-check
input.form-check-input#flexRadioDefault1(type='radio' name='flexRadioDefault')
label.form-check-label(for='flexRadioDefault1') Default radio
.form-check
input.form-check-input#flexRadioDefault2(type='radio' name='flexRadioDefault' checked)
label.form-check-label(for='flexRadioDefault2') Default checked radio
.col-12
.card.mb-4
.card-header
strong Radios
span.small.ms-1 Disabled
.card-body
p.text-body-secondary.small
| Add the
code disabled
| attribute and the associated
code
= '<label>'
| s are automatically styled to match with a lighter color to help indicate the input’s state.
+example('https://coreui.io/docs/forms/checks-radios/#disabled-1')
.form-check
input.form-check-input#flexRadioDisabled(type='radio' name='flexRadioDisabled' disabled)
label.form-check-label(for='flexRadioDisabled') Disabled radio
.form-check
input.form-check-input#flexRadioCheckedDisabled(type='radio' name='flexRadioDisabled' checked disabled)
label.form-check-label(for='flexRadioCheckedDisabled') Disabled checked radio
.row
.col-12
.card.mb-4
.card-header
strong Switches
.card-body
p.text-body-secondary.small
| A switch has the markup of a custom checkbox but uses the
code .form-switch
| class to render a toggle switch. Switches also support the
code disabled
| attribute.
+example('https://coreui.io/docs/forms/checks-radios/#switches')
.form-check.form-switch
input.form-check-input#flexSwitchCheckDefault(type='checkbox')
label.form-check-label(for='flexSwitchCheckDefault') Default switch checkbox input
.form-check.form-switch
input.form-check-input#flexSwitchCheckChecked(type='checkbox' checked)
label.form-check-label(for='flexSwitchCheckChecked') Checked switch checkbox input
.form-check.form-switch
input.form-check-input#flexSwitchCheckDisabled(type='checkbox' disabled)
label.form-check-label(for='flexSwitchCheckDisabled') Disabled switch checkbox input
.form-check.form-switch
input.form-check-input#flexSwitchCheckCheckedDisabled(type='checkbox' checked disabled)
label.form-check-label(for='flexSwitchCheckCheckedDisabled') Disabled checked switch checkbox input
.col-12
.card.mb-4
.card-header
strong Switches
span.small.ms-1 Sizes
.card-body
+example('https://coreui.io/docs/forms/checks-radios/#sizes')
.form-check.form-switch
input.form-check-input#flexSwitchCheckDefault(type='checkbox')
label.form-check-label(for='flexSwitchCheckDefault') Default switch checkbox input
.form-check.form-switch.form-switch-lg
input.form-check-input#flexSwitchCheckDefaultLg(type='checkbox')
label.form-check-label(for='flexSwitchCheckDefaultLg') Large switch checkbox input
.form-check.form-switch.form-switch-xl
input.form-check-input#flexSwitchCheckDefaultXl(type='checkbox')
label.form-check-label(for='flexSwitchCheckDefaultXl') Extra large switch checkbox input
.row
.col-12
.card.mb-4
.card-header
strong Checks and Radios
span.small.ms-1 Default layout (stacked)
.card-body
p.text-body-secondary.small
| By default, any number of checkboxes and radios that are immediate sibling will be vertically stacked and appropriately spaced with
code .form-check
| .
+example('https://coreui.io/docs/forms/checks-radios/#default-stacked')
.form-check
input.form-check-input#defaultCheck1(type='checkbox')
label.form-check-label(for='defaultCheck1') Default checkbox
.form-check
input.form-check-input#defaultCheck2(type='checkbox' disabled)
label.form-check-label(for='defaultCheck2') Disabled checkbox
+example('https://coreui.io/docs/forms/checks-radios/#default-stacked')
.form-check
input.form-check-input#exampleRadios1(type='radio' name='exampleRadios' value='option1' checked)
label.form-check-label(for='exampleRadios1') Default radio
.form-check
input.form-check-input#exampleRadios2(type='radio' name='exampleRadios' value='option2')
label.form-check-label(for='exampleRadios2') Second default radio
.form-check
input.form-check-input#exampleRadios3(type='radio' name='exampleRadios' value='option3' disabled)
label.form-check-label(for='exampleRadios3') Disabled radio
.col-12
.card.mb-4
.card-header
strong Checks and Radios
span.small.ms-1 Inline
.card-body
p.text-body-secondary.small
| Group checkboxes or radios on the same horizontal row by adding
code .form-check-inline
| to any
code .form-check
| .
+example('https://coreui.io/docs/forms/checks-radios/#inline')
.form-check.form-check-inline
input.form-check-input#inlineCheckbox1(type='checkbox' value='option1')
label.form-check-label(for='inlineCheckbox1') 1
.form-check.form-check-inline
input.form-check-input#inlineCheckbox2(type='checkbox' value='option2')
label.form-check-label(for='inlineCheckbox2') 2
.form-check.form-check-inline
input.form-check-input#inlineCheckbox3(type='checkbox' value='option3' disabled)
label.form-check-label(for='inlineCheckbox3') 3 (disabled)
+example('https://coreui.io/docs/forms/checks-radios/#inline')
.form-check.form-check-inline
input.form-check-input#inlineRadio1(type='radio' name='inlineRadioOptions' value='option1')
label.form-check-label(for='inlineRadio1') 1
.form-check.form-check-inline
input.form-check-input#inlineRadio2(type='radio' name='inlineRadioOptions' value='option2')
label.form-check-label(for='inlineRadio2') 2
.form-check.form-check-inline
input.form-check-input#inlineRadio3(type='radio' name='inlineRadioOptions' value='option3' disabled)
label.form-check-label(for='inlineRadio3') 3 (disabled)
.col-12
.card.mb-4
.card-header
strong Checks and Radios
span.small.ms-1 Without labels
.card-body
p.text-body-secondary.small
| Omit the wrapping
code .form-check
| for checkboxes and radios that have no label text. Remember to still provide some form of accessible name for assistive technologies (for instance, using
code aria-label
| ). See the
a(href='https://coreui.io/docs/forms/overview/#accessibility') forms overview accessibility
| section for details.
+example('https://coreui.io/docs/forms/checks-radios/#without-labels')
div
input.form-check-input#checkboxNoLabel(type='checkbox' aria-label='...')
div
input.form-check-input#radioNoLabel1(type='radio' name='radioNoLabel' aria-label='...')
.row
.col-12
.card.mb-4
.card-header
strong Toggle buttons
.card-body
p.text-body-secondary.small
| Create button-like checkboxes and radio buttons by using
code .btn
| styles rather than
code .form-check-label
| on the
code
= '<label>'
| elements. These toggle buttons can further be grouped in a
a(href='https://coreui.io/docs/components/button-group/') button group
| if needed.
h3#checkbox-toggle-buttons
| Checkbox toggle buttons
a.anchorjs-link(aria-label='Anchor' data-anchorjs-icon='#' href='#checkbox-toggle-buttons' style='padding-left: 0.375em;')
+example('https://coreui.io/docs/forms/checks-radios/#toggle-buttons')
input.btn-check#btn-check(type='checkbox' autocomplete='off')
label.btn.btn-primary(for='btn-check') Single toggle
+example('https://coreui.io/docs/forms/checks-radios/#toggle-buttons')
input.btn-check#btn-check-2(type='checkbox' checked autocomplete='off')
label.btn.btn-primary(for='btn-check-2') Checked
+example('https://coreui.io/docs/forms/checks-radios/#toggle-buttons')
input.btn-check#btn-check-3(type='checkbox' autocomplete='off' disabled)
label.btn.btn-primary(for='btn-check-3') Disabled
.col-12
.card.mb-4
.card-header
strong Toggle buttons
span.small.ms-1 Radio
.card-body
+example('https://coreui.io/docs/forms/checks-radios/#radio-toggle-buttons')
input.btn-check#option1(type='radio' name='options' autocomplete='off' checked)
label.btn.btn-secondary(for='option1') Checked
input.btn-check#option2(type='radio' name='options' autocomplete='off')
label.btn.btn-secondary(for='option2') Radio
input.btn-check#option3(type='radio' name='options' autocomplete='off' disabled)
label.btn.btn-secondary(for='option3') Disabled
input.btn-check#option4(type='radio' name='options' autocomplete='off')
label.btn.btn-secondary(for='option4') Radio
h3#outlined-styles
| Outlined styles
a.anchorjs-link(aria-label='Anchor' data-anchorjs-icon='#' href='#outlined-styles' style='padding-left: 0.375em;')
p.text-body-secondary.small
| Different variants of
code .btn
| , such at the various outlined styles, are supported.
+example('https://coreui.io/docs/forms/checks-radios/#radio-toggle-buttons')
input.btn-check#btn-check-outlined(type='checkbox' autocomplete='off')
label.btn.btn-outline-primary(for='btn-check-outlined') Single toggle
br
input.btn-check#btn-check-2-outlined(type='checkbox' checked autocomplete='off')
label.btn.btn-outline-secondary(for='btn-check-2-outlined') Checked
br
input.btn-check#success-outlined(type='radio' name='options-outlined' autocomplete='off' checked)
label.btn.btn-outline-success(for='success-outlined') Checked success radio
input.btn-check#danger-outlined(type='radio' name='options-outlined' autocomplete='off')
label.btn.btn-outline-danger(for='danger-outlined') Danger radio