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 title="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.
Accessibility
If the title is needed, but it must to not be displayed, it's possible to use the visuallyHidden
property to hide it.
<sbb-title visually-hidden>Screen-reader only.</sbb-title>
Properties
Name | Attribute | Privacy | Type | Default | Description |
---|---|---|---|---|---|
level | level | public | TitleLevel | undefined | '1' | Title level |
visualLevel | visual-level | public | TitleLevel | undefined | Visual level for the title. Optional, if not set, the value of level will be used. | |
visuallyHidden | visually-hidden | public | boolean | undefined | Sometimes we need a title in the markup to present a proper hierarchy to the screen readers while we do not want to let that title appear visually. In this case we set visuallyHidden to true | |
negative | negative | public | boolean | undefined | false | Choose negative variant |
Slots
Name | Description |
---|---|
Use the unnamed slot to display the title. |