Ein Button ist ein interaktives Element, das eine Aktion auslöst, wenn er angeklickt wird.
Nummer | Typ | Beschreibung | Optional | Hinweis |
---|---|---|---|---|
1 | Komponente | sbb-icon |
Ja | Ein Icon oder ein Label ist zu setzen. |
2 | Text | Label | Ja | Ein Icon oder ein Label ist zu setzen. |
The sbb-tertiary-button
component provides the same functionality as a native <button>
enhanced with the SBB Design in the 'tertiary' variant.
<sbb-tertiary-button>Button text</sbb-tertiary-button>
The button text is provided via an unnamed slot; the component can optionally display a sbb-icon
at the component start using the iconName
property or via custom content using the icon
slot.
At least one is mandatory, so you can have a sbb-tertiary-button
with icon only, text only, or with both.
<sbb-tertiary-button icon-name="info"> Button text </sbb-tertiary-button>
<sbb-tertiary-button>
<sbb-icon slot="icon" name="info"></sbb-icon>
Button text
</sbb-tertiary-button>
<sbb-tertiary-button
icon-name="info"
aria-label="Click for more information."
></sbb-tertiary-button>
The component is internally rendered as a button,
accepting its associated properties (type
, name
, value
and form
).
<sbb-tertiary-button type="submit" name="tickets" form="buy" value="tickets">
Buy tickets
</sbb-tertiary-button>
The component has a negative variant which can be set using the negative
property.
There are two different sizes (m
and l
, which is the default) that can be set using the size
property.
The component can be displayed in disabled
state using the self-named property.
<sbb-tertiary-button negative>Button</sbb-tertiary-button>
<sbb-tertiary-button size="m">Button</sbb-tertiary-button>
<sbb-tertiary-button disabled>Button</sbb-tertiary-button>
Please make sure that the focus outline appears in the correct color if the component is used on a dark background.
You can set it by re-defining the css var on sbb-tertiary-button
or any parent element:
sbb-tertiary-button {
--sbb-focus-outline-color: var(--sbb-focus-outline-color-dark);
}
Use the accessibility properties in case of an icon-only button to describe the purpose of the sbb-tertiary-button
for screen-reader users.
Name | Attribute | Privacy | Type | Default | Description |
---|---|---|---|---|---|
disabled |
disabled |
public | boolean |
false |
Whether the component is disabled. |
form |
form |
public | string | undefined |
The | |
iconName |
icon-name |
public | string | undefined |
The icon name we want to use, choose from the small icon variants from the ui-icons category from here https://icons.app.sbb.ch. | |
name |
name |
public | string |
The name of the button element. | |
negative |
negative |
public | boolean |
false |
Negative coloring variant flag. |
size |
size |
public | SbbButtonSize | undefined |
'l' |
Size variant, either l or m. |
type |
type |
public | SbbButtonType |
'button' |
The type attribute to use for the button. |
value |
value |
public | string |
The value of the button element. |
Name | Description |
---|---|
Use the unnamed slot to add content to the tertiary-button. | |
icon |
Slot used to display the icon, if one is set |