Eine Checkbox ist ein Auswahlfeld, das es Nutzenden ermöglicht, eine oder mehrere Optionen aus einer Liste auszuwählen oder abzuwählen.
Nummer | Typ | Beschreibung | Optional | Hinweis |
---|---|---|---|---|
1 | Text | Label | Nein |
The sbb-checkbox
component provides the same functionality as a native <input type="checkbox"/>
enhanced with the SBB Design.
It is possible to provide a label via an unnamed slot; the component can optionally display a sbb-icon
using
the iconName
property or via custom SVG using the icon
slot.
The icon can be placed before or after the label based on the value of the iconPlacement
property (default: end
).
<sbb-checkbox value="checkbox">Example</sbb-checkbox>
<sbb-checkbox value="icon" icon-name="tickets-class-small">Icon</sbb-checkbox>
<sbb-checkbox value="start-icon" icon-name="tickets-class-small" icon-placement="start"
>Icon at start</sbb-checkbox
>
The component could be checked or not depending on the value of the checked
attribute.
<sbb-checkbox value="checked-checkbox" checked>Checked state</sbb-checkbox>
It has a third state too, which is set if the indeterminate
property is true.
This is useful when multiple dependent checkboxes are used
(e.g., a parent which is checked only if all the children are checked, otherwise is in indeterminate state).
Clicking on a sbb-checkbox
in this state sets checked
to true
and indeterminate
to false.
<sbb-checkbox value="indeterminate-checkbox" indeterminate="true">Indeterminate state</sbb-checkbox>
The component can be displayed in disabled
or required
state by using the self-named properties.
<sbb-checkbox value="required-checkbox" required="true">Required</sbb-checkbox>
<sbb-checkbox value="disabled-checkbox" disabled="true">Disabled</sbb-checkbox>
The component has two size
, named s
and m
(default).
<sbb-checkbox value="size" size="m">Size</sbb-checkbox>
The component's label can be displayed in bold using the sbb-text--bold
class on a wrapper tag:
<sbb-checkbox value="bold">
<span class="sbb-text--bold">Bold label</span>
</sbb-checkbox>
Consumers can listen to the native change
event on the sbb-checkbox
component to intercept the input's change;
the current state can be read from event.target.checked
, while the value from event.target.value
.
The component provides the same accessibility features as the native checkbox.
Avoid adding other interactive controls into the content of sbb-checkbox
, as this degrades the experience for users of assistive technology.
Always provide an accessible label via aria-label
for checkboxes without descriptive text content.
If you don't want the label to appear next to the checkbox, you can use aria-label
to specify an appropriate label.
<sbb-checkbox aria-label="Subscribed to email message"></sbb-checkbox>
Name | Attribute | Privacy | Type | Default | Description |
---|---|---|---|---|---|
checked | checked | public | boolean | false | Whether the checkbox is checked. |
disabled | disabled | public | boolean | false | Whether the component is disabled. |
form | - | public | HTMLFormElement | null | Returns the form owner of internals target element. | |
group | - | public | SbbCheckboxGroupElement | null | null | Reference to the connected checkbox group. |
iconName | icon-name | public | string | undefined | The icon name we want to use, choose from the small icon variants from the ui-icons category from here https://icons.app.sbb.ch. | |
iconPlacement | icon-placement | public | SbbIconPlacement | 'end' | The label position relative to the labelIcon. Defaults to end |
indeterminate | indeterminate | public | boolean | false | Whether the checkbox is indeterminate. |
name | name | public | string | Name of the form element. Will be read from name attribute. | |
required | required | public | boolean | false | Whether the component is required. |
size | size | public | SbbCheckboxSize | 'm' | Label size variant, either m or s. |
value | value | public | string | null | null | Value of the form element. |
Name | Type | Description | Inherited From |
---|---|---|---|
change | Event | Event fired on change. | |
didChange | CustomEvent<void> | Deprecated. used for React. Will probably be removed once React 19 is available. | |
input | InputEvent | Event fired on input. |
Name | Description |
---|---|
Use the unnamed slot to add content to the sbb-checkbox . | |
icon | Slot used to render the checkbox icon (disabled inside a selection panel). |