Card
Description
<vaadin-card>
is a versatile container for grouping related content and actions.
It presents information in a structured and visually appealing manner, with
customization options to fit various design requirements. The default ARIA role is region
.
<vaadin-card role="region" theme="outlined cover-media">
<img slot="media" width="200" src="..." alt="">
<div slot="title">Lapland</div>
<div slot="subtitle">The Exotic North</div>
<div>Lapland is the northern-most region of Finland and an active outdoor destination.</div>
<vaadin-button slot="footer">Book Vacation</vaadin-button>
</vaadin-card>
Styling
The following shadow DOM parts are available for styling:
Part name | Description |
---|---|
media |
The container for the media element (e.g., image, video, icon). Shown above of before the card content. |
header |
The container for title and subtitle - or for custom header content - and header prefix and suffix elements. |
content |
The container for the card content (usually text content). |
footer |
The container for footer elements. This part is always at the bottom of the card. |
The following custom properties are available for styling:
Custom property | Description | Default |
---|---|---|
--vaadin-card-padding |
The space between the card edge and its content. Needs to a unified value for all edges, i.e., a single length value. | 1em |
--vaadin-card-gap |
The space between content elements within the card. | 1em |
See Styling Components documentation.
Properties
cardTitle
Type: string
The title of the card. When set, any custom slotted title is removed and this string-based title is used instead. If this title is used, an aria-labelledby
attribute that points to the generated title element is set.
titleHeadingLevel
Type: number | null | undefined
Sets the heading level (aria-level
) for the string-based title. If not set, the level defaults to 2. Setting values outside the range [1, 6] can cause accessibility issues.