Checkbox
Checkboxes are used to select one or multiple options in a list. They usually find their place in forms and are also used to accept some mentions.
States
Default states
The checkbox has two default states, checked and unchecked. Every state has a disabled and an invalid variation.
Indeterminate
This case is used when several items of a sublist are selected. In this specific case, the parent checkbox will have the indeterminate case displayed. Note that you can select or unselect every item of the sublist with this parent checkbox.
The above preview is given as an example, you cannot interact with it.
Checkbox item
The checkbox item is a combinaison of an input and a label.
A checkbox can't be used without an associated label.
Checkbox group
The checkbox group is a combination of the following mentions. Please note that you can use four different cases:
- Group label + checkbox-es
- Group label + requirement + checkbox-es
- Group label + requirement + help text + checkbox-es
- Groupe label + help text + checkbox-es
Group label
The label group helps the user to understand which box-es to check.
Requirement
This mention allows to specify that this information is mandatory for the input to be valid.
Please note that this mention can also be used to say a specific input is optional when the other ones are mandatory.
Help text
Help text corresponds to a relevant piece of information to make sure that the user understands what is needed.
Note that the elements become horizontally aligned from the
m-medium
breakpoint (768px). Below this resolution, the elements are arranged vertically.
Validation
There are two different elements for validation feedback:
- The color of the input outline.
- A text under the checkbox group explains what's wrong with the data entered.
Do's and Don'ts
Never use a checkbox to select one option from a list. Use a Radio instead.