Principles Foundation Accessibility Design System Guidelines Deutsch Français Italiano English Our design principles User-centred Recognisable Inclusive Reduced Holistic Self-explanatory Task-oriented Appropriate SBB Brand portal Logo Digital clock Rights of use Base colors Additional colors Off brand colors Icons Timetable icons Pictograms About accessibility Über diesen Guide Contact Further information Product Owner User Research Interaction Design Visual Design Development Content Design Testing What is a design system? Designing Coding FAQ Help Process Contribution Contact Overview Base Components Overview Releases Design Tokens Components Overview Base Informations Overview Base Components Overview App Icons Power-Apps Digital banner ads SAP Design Guidelines AI Design: Basics Title Info

What does the component do?

A title component is used to display headings and titles in different sizes and hierarchy levels in order to present content in a structured and clear manner.

When should the component be used?

  • To highlight the main heading of a page or section.
  • To present the structure and hierarchy of content clearly and comprehensibly.
  • To draw the user's attention to important information or topics.

Rules

  • Use the title component in different hierarchy levels (e.g. H1, H2, H3) to ensure a clear structure and readability.
  • Make sure that titles are used semantically correctly to improve accessibility and search engine optimisation (SEO).
  • Avoid too many titles on a page to ensure clarity.
 Anatomy

Anatomy of the component


Number Type Description Optional Info
1 Text Title No
Demo

Playground

Data without insights are trivial, and insights without action are pointless
Level H1 H2 H3 H4 H5 H6 Mode (System Setting) Light Dark Background White Midnight Milk Charcoal Cloud Iron Midnight White Charcoal Milk Iron Cloud
H 1
Try it out on Storybook Show HTML
H 1 Negative
Try it out on Storybook Show HTML
H 2
Try it out on Storybook Show HTML
H 3
Try it out on Storybook Show HTML
H 4
Try it out on Storybook Show HTML
H 5
Try it out on Storybook Show HTML
H 6
Try it out on Storybook Show HTML
H 6 Visual Level
Try it out on Storybook Show HTML
Lean Size
Try it out on Storybook Show HTML
Copy HTML to clipboard. Implementation

The sbb-title is a component which renders a heading element according to the provided level (default: 1).

<sbb-title>Hello</sbb-title>

Style

In scenarios where the visual representation needs to be different from the semantic meaning of the title level,
it is possible to use the visualLevel property.
The available values for both level and visualLevel are the numbers from 1 to 6 (h1 to h6).

<sbb-title level="3" visual-level="4">Hi!</sbb-title>

The component has a negative variant which can be set with the self-named property.

<sbb-title negative>Negative</sbb-title>

As a default the sbb-title contains spacing on top and bottom on the host.
This can be removed or customized via simple CSS rules.

Lean design

In lean mode, where the sbb-lean class is applied to the <html> tag, the title is given smaller sizes and spacings.

Properties

Name Attribute Privacy Type Default Description
level level public SbbTitleLevel '1' Title level
negative negative public boolean false Negative coloring variant flag.
visualLevel visual-level public SbbTitleLevel | null null Visual level for the title. Optional, if not set, the value of level will be used.

CSS Properties

Name Default Description
--sbb-title-margin-block-end var(--sbb-spacing-responsive-s) Margin block end of the title.
--sbb-title-margin-block-start var(--sbb-spacing-responsive-m) Margin block start of the title.

Slots

Name Description
Use the unnamed slot for the content of the title.
Contact

Do you have any questions? Maybe our FAQ or our help will be helpful, otherwise you can post your question on the corresponding board on Github.

Imprint Contact Data privacy Cookie settings