Zur Navigation Zum Inhalt Kontakt Menu Trova un componente Descrizione generale Lyne Principi Base Accessibilité Sistema di design Guidelines Deutsch Français Italiano English I nostri principi di design Soluzioni focalizzate sull’utente Riconoscibilità Inclusione Riduzione Olistico Autoesplicativo Orientamento all’attività Adeguatezza Portale della marca FFS Logo Orologio digitale Diritti di utilizzazione Colori die base Colori funzionali Colori Off Brand Icone Icone dell'orario Pittogrammi Informazioni sull’accessibilità Über diesen Guide Contatti Letture consigliate Product Owner User Research Interaction Design Visual Design Development Content Design Testing What is a design system? Designing Coding FAQ Aiuto Processo Contribution Contatto Introduzione Base Componenti Introduzione Base Componenti Introduzione Base Componenti Overview Releases Design Tokens Komponenten Introduzione Base Informazioni Senso & scopo Community Assets Istruzioni Power-Apps Banner pubblicitari digitali SAP Icone delle app Questa pagina non è disponibile nella lingua desiderata. Lingue disponibili Deutsch English Checkbox Implementation

The sbb-checkbox component provides the same functionality as a native <input type="checkbox"/> enhanced with the SBB Design.

Slots

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
>

States

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>

Style

The component has two size, named s (default) and m.

<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>

Events

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.

Accessibility

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>

Properties

Name Attribute Privacy Type Default Description
indeterminate indeterminate public boolean false Whether the checkbox is indeterminate.
iconPlacement icon-placement public SbbIconPlacement 'end' The label position relative to the labelIcon. Defaults to end
size size public SbbCheckboxSize 'm' Label size variant, either m or s.
group - public SbbCheckboxGroupElement | null null Reference to the connected checkbox group.
checked checked public boolean false Whether the checkbox is checked.
disabled disabled public boolean false Whether the component is disabled.
required required public boolean false Whether the component is required.
form - public HTMLFormElement | null Returns the form owner of internals target element.
name name public string Name of the form element. Will be read from name attribute.
value value public string | null null Value of the form element.
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.

Events

Name Type Description Inherited From
didChange CustomEvent<void> Deprecated. used for React. Will probably be removed once React 19 is available.
change Event Event fired on change.
input InputEvent Event fired on input.

Slots

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).
subtext Slot used to render a subtext under the label (only visible within a selection panel).
suffix Slot used to render additional content after the label (only visible within a selection panel).
Beispiele
Default Unchecked
Default Checked
Default Indeterminate
Size M
Long Label
With Icon End
Checked With Icon Start
Disabled Checked
Disabled Unchecked
Disabled Indeterminate
With Form
Default Unchecked Bold
Default Checked Bold
Default Indeterminate Bold
HTML-Markup kopiert.
Playground
Example
Grössen S M Disabled Nein Ja Unbestimmt Nein Ja Icon Position Am Anfang Am Ende Hintergrund White Milk Iron Charcoal Black
Trova un componente

Lyne

Impressum Contatto Impostazioni dei cookie