Title. Übersicht

Vorschau.

Data without insights are trivial, and insights without action are pointless

Was macht die Komponente?

Die Title-Komponente stellt Überschriften in sechs Hierarchiestufen (H1–H6) dar und gliedert Inhalte klar.

Wann soll die Komponente eingesetzt werden?

  • Für die Hauptüberschrift einer Seite oder eines Abschnitts.
  • Um die Struktur und Hierarchie von Inhalten abzubilden.
Anwendung

Regeln.

  • Die Stufe (level) richtet sich nach der Struktur der Seite, nicht nach der gewünschten Grösse. Keine Stufen überspringen, pro Seite nur eine H1.
  • Weicht die Darstellung von der Semantik ab, wird die optische Grösse mit visualLevel gesetzt.
  • Auf dunklem Hintergrund die negative Variante verwenden.
  • Zu viele Titel auf einer Seite vermeiden.

Spezifikation.

Beispiele H 1.
H 1 Negative.
H 2.
H 3.
H 4.
H 5.
H 6.
H 6 Visual Level.
Lean Size.
HTML in Zwischenablage kopiert.
Implementation

Web Components.

Die Web Component ist im Paket @sbb-esta/lyne-elements enthalten.

Storybook mit Live-Beispielen Quellcode auf GitHub

Dokumentation.

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

With the lean theme, the title is given smaller sizes and spacings.

Angular.

Diese Komponente gibt es auch für Angular im Paket @sbb-esta/lyne-angular.

Angular-Übersicht Angular-API Angular-Beispiele
API

class: SbbTitleElement, sbb-title.

Properties.

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

Slots.

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