Card
<wa-card>
Cards can be used to group related subjects in a container.
This kitten is as cute as he is playful. Bring him home today!
6 weeks old
<wa-card class="card-overview"> <img slot="media" src="https://images.unsplash.com/photo-1559209172-0ff8f6d49ff7?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=500&q=80" alt="A kitten sits patiently between a terracotta pot and decorative grasses." /> <strong>Mittens</strong><br /> This kitten is as cute as he is playful. Bring him home today!<br /> <small class="wa-caption-m">6 weeks old</small> <div slot="footer" class="wa-split"> <wa-button variant="brand" pill>More Info</wa-button> <wa-rating label="Rating"></wa-rating> </div> </wa-card> <style> .card-overview { width: 300px; } </style>
Examples Jump to heading
Basic Card Jump to heading
Basic cards aren't very exciting, but they can display any content you want them to.
<wa-card class="card-basic"> This is just a basic card. No media, no header, and no footer. Just your content. </wa-card> <style> .card-basic { max-width: 300px; } </style>
Card with Header Jump to heading
Headers can be used to display titles and more.
If using SSR, you need to also use the with-header
attribute to add a header to the card (if not, it is added automatically).
<wa-card class="card-header"> <div slot="header" class="wa-split"> Header Title <wa-button appearance="plain"> <wa-icon name="gear" variant="solid" label="Settings"></wa-icon> </wa-button> </div> This card has a header. You can put all sorts of things in it! </wa-card> <style> .card-header { max-width: 300px; } .card-header h3 { margin: 0; } </style>
Card with Footer Jump to heading
Footers can be used to display actions, summaries, or other relevant content.
If using SSR, you need to also use the with-footer
attribute to add a footer to the card (if not, it is added automatically).
<wa-card class="card-footer"> This card has a footer. You can put all sorts of things in it! <div slot="footer" class="wa-split"> <wa-rating></wa-rating> <wa-button variant="brand">Preview</wa-button> </div> </wa-card> <style> .card-footer { max-width: 300px; } </style>
Media Jump to heading
Card media is displayed atop the card and will stretch to fit.
If using SSR, you need to also use the with-media
attribute to add a media section to the card (if not, it is added automatically).
<div class="wa-grid"> <wa-card class="card-media"> <img slot="media" src="https://images.unsplash.com/photo-1547191783-94d5f8f6d8b1?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=400&q=80" alt="A kitten walks towards camera on top of pallet." /> This is a kitten, but not just any kitten. This kitten likes walking along pallets. </wa-card> <wa-card class="card-media"> <video slot="media" controls> <source src="https://uploads.webawesome.com/dog-with-glasses.mp4" /> <p>Your browser doesn't support HTML video</p> </video> This is a kitten, but not just any kitten. This kitten likes walking along pallets. </wa-card> </div> <style> .card-media { max-width: 300px; } </style>
Appearance Jump to heading
Use the appearance
attribute to change the card's visual appearance.
<div class="wa-grid"> <wa-card> <img slot="media" src="https://images.unsplash.com/photo-1559209172-0ff8f6d49ff7?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=500&q=80" alt="A kitten sits patiently between a terracotta pot and decorative grasses." /> Outlined (default) </wa-card> <wa-card appearance="outlined filled"> <img slot="media" src="https://images.unsplash.com/photo-1559209172-0ff8f6d49ff7?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=500&q=80" alt="A kitten sits patiently between a terracotta pot and decorative grasses." /> Outlined filled </wa-card><wa-card appearance="plain"> <img slot="media" src="https://images.unsplash.com/photo-1559209172-0ff8f6d49ff7?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=500&q=80" alt="A kitten sits patiently between a terracotta pot and decorative grasses." /> Plain </wa-card><wa-card appearance="filled"> <img slot="media" src="https://images.unsplash.com/photo-1559209172-0ff8f6d49ff7?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=500&q=80" alt="A kitten sits patiently between a terracotta pot and decorative grasses." /> Filled </wa-card><wa-card appearance="accent"> <img slot="media" src="https://images.unsplash.com/photo-1559209172-0ff8f6d49ff7?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=500&q=80" alt="A kitten sits patiently between a terracotta pot and decorative grasses." /> Accent </wa-card> </div>
Slots Jump to heading
Learn more about using slots.
Name | Description |
---|---|
(default) | The card's main content. |
header
|
An optional header for the card. |
footer
|
An optional footer for the card. |
media
|
An optional media section to render at the start of the card. |
Attributes & Properties Jump to heading
Learn more about attributes and properties.
Name | Description | Reflects | |
---|---|---|---|
appearance appearance |
The card's visual appearance.
Type
'accent' | 'filled' | 'outlined' | 'plain' Default
'outlined' |
|
|
withHeader with-header |
Renders the card with a header. Only needed for SSR, otherwise is automatically added.
Type
boolean Default
false |
|
|
withMedia with-media |
Renders the card with an image. Only needed for SSR, otherwise is automatically added.
Type
boolean Default
false |
|
|
withFooter with-footer |
Renders the card with a footer. Only needed for SSR, otherwise is automatically added.
Type
boolean Default
false |
|
CSS custom properties Jump to heading
Learn more about CSS custom properties.
Name | Description |
---|---|
--spacing |
The amount of space around and between sections of the card. Expects a single value.
Default
var(--wa-space-l)
|
CSS parts Jump to heading
Learn more about CSS parts.
Name | Description |
---|---|
media |
The container that wraps the card's media. |
header |
The container that wraps the card's header. |
body |
The container that wraps the card's main content. |
footer |
The container that wraps the card's footer. |
Importing Jump to heading
The autoloader is the recommended way to import components. If you prefer to do it manually, use one of the following code snippets.
To manually import this component from the CDN, use the following code.
import 'https://early.webawesome.com/[email protected]/dist/components/card/card.js';
To manually import this component from NPM, use the following code.
import '@awesome.me/webawesome/dist/components/card/card.js';
To manually import this component from React, use the following code.
import '@awesome.me/webawesome/dist/react/card';