Zur Navigation Zum Inhalt Kontakt Menu Trouver un composant Aperçu Lyne Principes Bases Accessibilité Système de design Guidelines Deutsch Français Italiano English Nos principes de design Centré sur l’utilisateur Reconnaissable Inclusif Minimaliste Holistique Auto-explicatif Axé sur les tâches Approprié Portail de la marque CFF Logo Horloge numérique Droits d’utilisation Couleurs de base Couleurs fonctionnelles Couleurs off-brand Icônes Icônes de l’horaire Pictogrammes À propos de l’accessibilité À propos de ce guide Contact Informations complémentaires Product Owner User Research Interaction Design Visual Design Development Content Design Testing What is a design system? Conception Développer FAQ Aide Procès Contribution Contact Aperçu Base Composants Overview Releases Design Tokens Komponenten Aperçu Base Informations Aperçu Base Composants Aperçu Base Composants Sens & objectif Community Assets Instructions Power-Apps Bandeaux publicitaires numériques SAP Icônes d’applications Cette page n'est pas disponible dans la langue souhaitée. Langues disponibles Deutsch English Overlay Implementation

The sbb-overlay component provides a way to present content on top of the app's content
and it's similar to the sbb-dialog.
It offers the following features:

  • disables scrolling of the page content while open;
  • manages focus properly by setting it on the first focusable element;
  • has a close button, which is always visible;
  • can display a back button;
  • adds the appropriate ARIA roles automatically.
<sbb-overlay id="my-overlay">
  <p>Overlay content.</p>


There is only one unnamed slot to provide the overlay content.


Setting the expanded property will cause the sbb-overlay component to take up the full width of the page.

It's possible to display the component in negative variant using the self-named property.

<sbb-overlay negative>
  <p>Overlay content.</p>


In order to show the overlay, you need to call the open(event?: PointerEvent) method on the sbb-overlay component.
It is necessary to pass the event object to the open() method to allow the overlay to detect
whether it has been opened by click or keyboard, so that the focus can be better handled.

  label="Open overlay"
  click="openDialog(event, 'my-overlay')"

<sbb-overlay id="my-overlay">
  <p>Overlay content.</p>

  const openOverlay = (event, id) => {
    const overlay = document.getElementById(id);

To dismiss the overlay, you need to get a reference to the sbb-overlay element and call
the close(result?: any, target?: HTMLElement) method, which will close the overlay element and
emit a close event with an optional result as a payload.

The component can also be dismissed by clicking on the close button, clicking on the backdrop, pressing the Esc key,
or, if an element within the sbb-overlay has the sbb-overlay-close attribute, by clicking on it.

You can also set the property backButton on the sbb-overlay-title component to display the back button in the title section which will emit the event requestBackAction when clicked.


When using a button to trigger the overlay, ensure to manage the appropriate ARIA attributes on the button element itself. This includes: aria-haspopup="dialog" that signals to assistive technologies that the button controls an overlay element,
aria-controls="overlay-id" that connects the button to the overlay by referencing the overlay's ID. Consider using aria-expanded to indicate the overlay's current state (open or closed).


Name Attribute Privacy Type Default Description
expanded expanded public boolean false Whether to allow the overlay content to stretch to full width. By default, the content has the appropriate page size.
backButton back-button public boolean false Whether a back button is displayed next to the title.
accessibilityCloseLabel accessibility-close-label public | string | undefined This will be forwarded as aria-label to the close button element.
accessibilityBackLabel accessibility-back-label public | string | undefined This will be forwarded as aria-label to the back button element.
accessibilityLabel accessibility-label public string | undefined This will be forwarded as aria-label adn will describe the purpose of the dialog.
negative negative public boolean false Negative coloring variant flag.


Name Privacy Description Parameters Return Inherited From
open public Opens the overlay element. void
close public Closes the overlay element. result: any, target: HTMLElement any


Name Type Description Inherited From
willOpen CustomEvent<void> Emits whenever the sbb-overlay starts the opening transition. Can be canceled.
didOpen CustomEvent<void> Emits whenever the sbb-overlay is opened.
willClose CustomEvent<void> Emits whenever the sbb-overlay begins the closing transition. Can be canceled.
didClose CustomEvent<SbbOverlayCloseEventDetails> Emits whenever the sbb-overlay is closed.
requestBackAction CustomEvent<void> Emits whenever the back button is clicked.

CSS Properties

Name Default Description
--sbb-overlay-z-index var(--sbb-overlay-default-z-index) To specify a custom stack order, the z-index can be overridden by defining this CSS variable. The default z-index of the component is set to var(--sbb-overlay-default-z-index) with a value of 1000.


Name Description
Use the unnamed slot to provide a content for the overlay.
With Back Button
HTML-Markup kopiert.
Overlay öffnen
Dialog content
Negativ Nein Ja Hintergrund White Milk Iron Charcoal Black
Trouver un composant


Impressum Contact Paramètres des cookies