Was macht die Komponente?
Eine Card ist ein flexibles Container-Element, das verschiedene Arten von Inhalten und Aktionen in einem einheitlichen Block zusammenfasst.
Wann soll die Komponente eingesetzt werden?
- Um zusammengehörige Informationen kompakt darzustellen.
- Um visuelle Hierarchien und Struktur in eine Seite zu bringen.
- Um Inhalte wie Texte und Aktionen zusammen darzustellen.
Regeln
- Die Inhalte innerhalb einer Card sollen logisch zusammenhängen und gut strukturiert sein. Der Inhalt sollte so knapp wie möglich formuliert werden.
- Hat eine Card mehrere Interaktive Elemente, so liegen die Klick-Targets auf den eingesetzten interaktiven Elementen. Hat die Card nur ein interaktives Element, so dient die ganze Card als Klick-Target.
| Nummer | Typ | Beschreibung | Optional | Hinweis |
|---|---|---|---|---|
| 1 | Slot | Beliebiger Inhalt erlaubt | Nein | |
| 2 | Komponente | sbb-card-badge | Ja |
Spielwiese
Default
With Card-Link
The sbb-card component is a generic content container; its task is to contain content related to a single subject.
<sbb-card>Card content</sbb-card>
Slots
The content is projected in an unnamed slot.
It's possible to use the component together with the sbb-card-badge and the sbb-card-button/sbb-card-link.
With sbb-card-badge
The sbb-card-badge component can be used to display a badge in the upper right corner.
For API details, see the sbb-card-badge docs.
<sbb-card color="white">
<sbb-card-badge>
<span>%</span>
<span>from CHF</span>
<span>19.99</span>
</sbb-card-badge>
Card content
</sbb-card>
With sbb-card-button/sbb-card-link
To add an action to a card, add a sbb-card-button or a sbb-card-link to the main slot.
With these components, all the card area becomes clickable.
For API details (mainly accessibility), see the sbb-card-button or
the sbb-card-link docs.
<sbb-card>
<sbb-card-link href="https://www.sbb.ch">Check all the wonderful trips available.</sbb-card-link>
Buy trips
</sbb-card>
<sbb-card>
<sbb-card-button type="submit" form="buy" value="trip">Buy this trip.</sbb-card-button>
</sbb-card>
Style
Generally, the padding of the sbb-card can be set directly on the host. However, it's possible to choose among
different preset spacing classes.
<sbb-card class="sbb-card-spacing-3x-xxs">Card content</sbb-card>
<sbb-card class="sbb-card-spacing-xxxs-xxs">Card content</sbb-card>
<sbb-card class="sbb-card-spacing-xxxs-s">Card content</sbb-card>
<sbb-card class="sbb-card-spacing-4x-xxs">Card content</sbb-card>
<sbb-card class="sbb-card-spacing-xxs">Card content</sbb-card>
<sbb-card class="sbb-card-spacing-s">Card content</sbb-card>
<sbb-card class="sbb-card-spacing-l">Card content</sbb-card>
The component has four different values to choose from for the color property; default is white.
<sbb-card color="milk">Card content</sbb-card>
<sbb-card color="transparent-bordered">Card content</sbb-card>
<sbb-card color="transparent-bordered-dashed">Card content</sbb-card>
Accessibility
Normally, a sbb-card should be a single action, however, it's possible to place other interactive elements
in the card content. Interactive content will automatically be detected and made accessible to click / focus.
In cases where there should be only a visual button or link inside the card content without a different action, the
static component should be used (e.g. <sbb-button-static></sbb-button-static>).
Windows High Contrast Notes
In high contrast mode, all the content of a link or a button receives a specific color which overrides every other color.
However, as the content of the card is not directly inside the button or link,
this does not happen when the slotted content has a specific color set.
To improve coloring, it's needed to manually define styles for Window high contrast mode (setting LinkText or ButtonText).
Properties
| Name | Attribute | Privacy | Type | Default | Description |
|---|---|---|---|---|---|
color | color | public | 'white' | 'milk' | 'transparent-bordered' | 'transparent-bordered-dashed' | 'white' | Option to set the component's background color. |
Slots
| Name | Description |
|---|---|
| Use the unnamed slot to add content to the card. | |
action | Use this slot to render a sbb-card-button or a sbb-card-link component. |
badge | Use this slot to render a sbb-card-badge component. |