v5.0.0

5.0.0 (2026-06-10)

⚠ BREAKING CHANGES

• support for the sbb-lean CSS class has been removed. Use the lean-theme.css instead of the standard-theme.css to have the lean styles applied. For off-brand and safety variants there are respective variants too.
• dialog: the sbb-dialog is not full size in 'zero' breakpoint anymore, but it opens from the bottom like the menu, adapting its height to the slotted content. From 'small' breakpoint, the width adapts to the content too.
• header: The expandFrom property of <sbb-header-button> and <sbb-header-link> has been renamed to hideLabelBelow and no longer has a default value. Previously, expandFrom defaulted to large. To preserve the existing behavior, all instances of <sbb-header-button> and <sbb-header-link> that do not explicitly define expandFrom must now be configured with hide-label-below="large".
• calendar: The sbb-calendar wide property has been replaced with the amount property and the selected property has been replaced with the value property.
• action-group, sbb-dialog-actions: The properties orientation, alignGroup, horizontalFrom, buttonSize and linkSize have been removed from the sbb-action-group and sbb-dialog-actions elements. Further, the global align-self attribute has been removed. Consumers can apply their custom flex styles directly on host of the sbb-action-group and sbb-dialog-actions elements.
• popover: The properties hide-close-button and accessibilityCloseLabel of the <sbb-popover> have been removed. Slot the <sbb-popover-close-button> element whenever a close button is needed.
• tag-group: The property listAccessibilityLabel of the <sbb-tag-group> has been renamed to accessibilityLabel.
• form-field: The optional property of the sbb-form-field has been removed. The (optional) string should be managed by consumer inside the <label>.
• The type of several events have been changed from CustomEvents to specific events which extend the native Event (see details in #4918).
• table: the sbb-tabledefault row styling has been changed from striped to unstriped. To achieve the striped look, use the CSS class sbb-table--striped on your table.
• <sbb-screen-reader-only> component has been removed. Use the CSS class sbb-screen-reader-only as a replacement.
• title: the CSS variables --sbb-title-text-color-normal and --sbb-title-text-color-normal-override have been renamed to --sbb-title-color.
• train: In order to mitigate the new requirements the following breaking changes were introduced:
  • The property type of sbb-train-wagon has been renamed towagon-type
  • The default inline padding of sbb-train-formation was changed from 0 to var(--sbb-spacing-fixed-1x)
  • The CSS variable --sbb-train-formation-padding-inline was renamed to --sbb-train-formation-scroll-padding
• journey-header: The size property of the sbb-journey-header has been removed. Use the visualLevel property to set the font-size by using the following mapping from size to visualLevel: s -> 6, m -> 5, l > 4.
• button, action-group: The default size of the buttons has changed from l to m in standard theme. The sbb-action-group doesn't have a default buttonSize and linkSize applied anymore but delegates the default size choice to slotted button and links.
• Various TypeScript types have been removed. SbbTitleLevel was renamed to SbbHeadingLevel and moved to core module.
• autocomplete, select: Deleted core/overlay mixins
• sbb-chip-label: chip-label Sass mixins were removed. As the chip-label styles were moved to the host, the chip-label can behave slightly different in text flow.
• removed the automatic ID assignment from the following components: sbb-tab, sbb-menu, sbb-dialog, sbb-popover, sbb-tooltip, sbb-stepper, sbb-datepicker, sbb-overlay, sbb-navigation, sbb-navigation-section.
• option: sbb-option does not automatically assign an ID anymore
• core: deleted setAriaOverlayTriggerAttributes and removeAriaOverlayTriggerAttributes methods.
• link: the size property has been removed from sbb-link,sbb-link-button and sbb-link-static, since it has effects only on block-links.
• navigation: The size property of the sbb-navigation-button and sbb-navigation-link has been removed.
• Some global CSS refactorings have been executed.
  • The Sass text mixins ending with -bold have been removed. Just use
    font-weight: bold.
  • The suffix --regular of the Sass text mixins were removed. E.g.
    text-s--regular becomes text-s.
  • The CSS file disable-animation.css was renamed to
    disable-animation-extension.css
  • The CSS variable --sbb-title-margin-block has been removed. Margins
    can directly be written from outside.
  • Various Sass mixins were removed or renamed.
  • The CSS classes sbb-table-header-cell, sbb-table-header-row and
    sbb-table-data-cell have been removed.
• Elements no longer have side effects (i.e. register globally) unless imported via the non-pure entrypoint or when calling define(). Additionally, SbbElement is now enforced as the base class for all elements and the mixins SbbElementInternalsMixin and SbbHydrationMixin have been inlined into SbbElement and therefore removed.
• The library now targets es2023

Features

• calendar: add property amount to enable displaying multiple months (#4940) (7d2b19c)
• calendar: add property fixedMonth to disable navigation (#4961) (ce201ab)
• calendar: allow shift selection with multiple (#4933) (f60489a)
• expose module Sass mixins globally (#4939) (0c01c99), closes #3969
• navigation: introduce disabled state navigation actions (#4891) (0f0b0fe)
• sbb-header: add variable to customize top padding (#4964) (fabcca3)
• train: vertical orientation and interactive wagon (#4796) (e0e2268), closes #4277
• dialog: adapt sizing (#4774) (7962982)
• sbb-chip-label: add size xxxs and css refactoring (#4650) (a809369), closes #4800
• teaser-panel: component implementation (#4779) (49749de)

Bug Fixes

• ensure stable state for inputs while editing (#4951) (91a12a1)
• expansion-panel: fix ssr rendering with 'title-level' (#4928) (3da1368)
• fix scrollbar background color in nested cases (#4968) (d2c720b)
• handle name change correctly for radio button based elements (#4970) (8c865d7)
• resolve title mixin naming conflict (#4947) (63cf10b)
• seat-reservation: fix service icon streching (#4965) (5f0bb65)
• seat-reservation: no place selectable by using screen reader (#4922) (483dc45)
• slider: fix 0 value handling (#4977) (a064887)
• link: remove size property from inline links (#4746) (2c9434d)

Documentation

• add complex action-group example (#4960) (9141c9d), closes #3582
• navigation: fix readme (#4948) (d341925)

Code Refactoring

• action-group, sbb-dialog-actions: simplify implementation (#4829) (75ecdda)
• checkbox, radio-button: add group property watcher (#4934) (ecc503b)
• form-field: remove deprecated optional property (#4931) (01cbc06)
• header: rename action property from expandFrom to hideLabelBelow and unset default (bb51e4e)
• optimize styles (#4913) (78a118b)
• option: remove automatic id assignment (#4936) (23b8965)
• popover: extract close button from shadow DOM (#4937) (e3f0075)
• remove various internal APIs (#4930) (e7c793a)
• replace CustomEvents with specific events (#4918) (523d403)
• tag-group: improve accessibility of exclusive selection (#4916) (30782dc)
• inline types from core (#4864) (58ecafb)
• introduce lean theme (#4865) (302417a)
• navigation: remove size property of buttons and links (#4908) (13d1a74)
• option: adapt global css rules to lean theme (#4875) (62be732)
• avoid duplicating scrollbar styles in shadow DOM (#4860) (df9c718)
• journey-header: remove size property (#4842) (8a3172b)
• merge styles in SbbElement (#4856) (b87b86b), closes #4647
• minimize payload of sbb-screen-reader-only styles (#4849) (4e5f34f)
• move box-sizing to SbbElement (#4871) (599a638)
• title: CSS refactoring (#4847) (7993f82)
• button, action-group: change default size value from l to m (#4825) (963894a)
• core: delete aria-attributes util functions (057f98b)
• improve support for scrollbar styles in shadow DOM (#4811) (1bf4726)
• navigation: css refactoring (#4622) (aee15d0)
• remove automatic ID assignment (057f98b)
• sbb-alert: css refactoring (#4376) (96cd622)
• stepper: remove pre-defined font-size of sbb-step (#4819) (c08f2ee)
• adapt pure entry points to be without side effects (#4707) (978018e)

Styles

• table: table default is unstriped (#4907) (d997cd1)
• autocomplete, select: ux redesign (#4850) (35df814)