v0.9.4defuss-shadcn
Theme

defuss-shadcn / Data Display / card

Built with: CSS

CardMOL

Content container with header, body, and footer regions. Use <div> for layout grouping or <article> for standalone content.

On this page (20)
Component Skill — components/card/component-skill.md

Native basis

<div> for layout grouping. <article> for standalone self-contained content.

Web Platform APIs

CSS Container Queries (@container)aspect-ratio

Classes

.card.card-header.card-title.card-description.card-content.card-footer.card-body.card-media

Data attributes (on .card)

data-variantoutline, dashed, ghost, muted, elevated, primary, neutral (charcoal), glassdata-sizexs, sm, md (default), lg, xl - padding and type scale togetherdata-densitycompact, comfortable (default), spacious - combines with data-sizedata-layoutside, auto (side while the card is wide enough), overlay (image as background)data-aligncenter - centered content and actionsdata-interactive / a.cardlifts on hover, focus ringlabel.cardselectable: a checked checkbox / radio inside rings the card.card-media[data-inset]padded, rounded media instead of edge to edge

Notes

• Card is a container pattern - its children define its purpose

• Avoid deeply nesting cards (card inside card) - use --muted surface instead

• For interactive cards (click to navigate), put the card classes on an <a> - it lifts on hover and shows a focus ring

• On primary / neutral cards, use secondary or outline buttons - a default button matches the card surface

• Shapes, frames, stacks and aura from Shapes compose with any card

• card-footer uses padding-top: 0 to avoid double-spacing with card-content

• For a card grid, use CSS Grid on the parent - the card itself has no layout opinion

§Standard

Header, content with form fields, and footer with actions.

§Metric

Compact card for dashboard stats. Header row with icon.

§With Image

Use <article> for standalone content. Image as first child.

§Header Action

Action button in the header for settings or overflow menus.

§Header Only

A title + description panel with no content or footer: the header is the last section, so it keeps its bottom padding.

§Variants

data-variant on the card: outline (no fill), dashed (a 2px dashed border - a drop zone or placeholder), ghost (no border, no fill), muted (a soft surface), elevated (a shadow instead of a border), primary and neutral (inverse) surfaces, and glass - frosted, over whatever is behind it.

§Sizes

data-size scales padding and type together: xs, sm, md (the default), lg, xl. It combines with data-density, which scales only the whitespace.

§Media

A .card-media figure edge to edge - first for an image on top, last for one at the bottom. data-inset pads and rounds it; with data-align="center" that is the centered product look.

§Image on the side

data-layout="side": media | body in one row. Put the figure after the .card-body for the image on the right.

§Responsive by its own width

data-layout="auto": side by side while the CARD is wide enough, stacked when it is not. The switch follows the card's own width, not the screen - the same card, in a narrow and a wide column.

§Image overlay

data-layout="overlay": the image is the background, the body sits on a dark scrim at the bottom, in white.

§Badges and indicators

A badge in the title, tag badges in the footer, and an .indicator pinning a "New" badge to the card's corner.

§Pricing with an aura

A pricing card: badge, price, a feature list with what is included and what is not, and a full-width button. The aura-rainbow wrapper from Shapes singles out the plan to pick.

§Selectable cards

A label.card around a radio or checkbox: the whole card is the hit area, the checked one takes a primary ring, keyboard focus shows a focus ring - no JavaScript. The native input stays in charge of the value and the form.

§Link cards

Put the card classes on an <a> (or add data-interactive): it lifts on hover and shows a focus ring on keyboard focus - under reduced motion it stays put.

§Colors

Primary and neutral (charcoal) surfaces for a call to action, and any color of your own through the tokens a card reads (--card, --card-foreground, --border). Ghost and link buttons on a colored card follow its text color; use secondary or outline buttons for the main action.

§Shapes, frames and stacks

Every shape utility from Shapes composes with a card: cut and scooped corners, an organic leaf corner, tape and a polaroid frame, an app window, a hard offset shadow, and a stack of sheets behind it.

§With an aura

Any aura from Shapes wraps a card: the default light, a glow halo, gold.

§Density

Set data-density on the component root to scale its internal whitespace. A whitespace policy, not a zoom: only gaps and padding scale (ratio 0.75 / 1 / 1.25), typography and fixed dimensions stay identical. comfortable matches the unsized default.

§CSS view file

/* -- Card component -------------------------------------------- */
@layer components {
  /* Spacing runs through one private variable: --_pad (section padding) =
     --_base (the SIZE's padding, md 1.5rem) × --_k (the DENSITY factor), and
     --_hf (the header→footer gap when no content sits between them) =
     --_hfb × --_kh. Size and density therefore combine instead of fighting.
     --_title / --_desc carry the size's type scale. All private. */
  .card {
    --_base: 1.5rem;
    --_hfb: 1rem;
    --_k: 1;
    --_kh: 1;
    --_pad: calc(var(--_base) * var(--_k));
    --_hf: calc(var(--_hfb) * var(--_kh));
    background-color: var(--card);
    color: var(--card-foreground);
    border: 1px solid var(--border);
    border-radius: var(--radius-xl);
    overflow: hidden;
    container-type: inline-size;
  }
  .card-header {
    display: flex;
    flex-direction: column;
    gap: 0.25rem;
    padding: var(--_pad, 1.5rem);
    padding-bottom: 0;
  }
  .card-title {
    font-size: var(--_title, 1.25rem);
    font-weight: 600;
    line-height: 1.25;
    letter-spacing: -0.01em;
    margin: 0;
  }
  .card-description {
    font-size: var(--_desc, 0.875rem);
    color: var(--muted-foreground);
    margin: 0;
    line-height: 1.6;
  }
  .card-content {
    padding: var(--_pad, 1.5rem);
  }
  .card-footer {
    display: flex;
    align-items: center;
    gap: 0.5rem;
    padding: var(--_pad, 1.5rem);
    padding-top: 0;
  }
  /* Header + footer with no .card-content between: the zeroed paddings would
     glue them together - restore the gap for that composition only. */
  .card-header + .card-footer {
    padding-top: var(--_hf, 1rem);
  }
  /* A header-only card (a title + description panel): the header is the last
     section, so it keeps its bottom padding instead of sitting on the edge. */
  .card-header:last-child {
    padding-bottom: var(--_pad, 1.5rem);
  }
  /* -- Body: an optional wrapper around header / content / footer.
     Needed for the side and overlay layouts (media | body); in a column it
     pushes the footer to the bottom, so a row of cards lines up its actions. */
  .card-body {
    display: flex;
    flex-direction: column;
    min-width: 0;
    & > .card-footer { margin-top: auto; }
  }
  /* -- Media: a figure (img / video / picture / svg) edge to edge - first
     child for an image on top, last child for one at the bottom. 16:9 unless
     the author sets an aspect-ratio. data-inset pads and rounds it instead
     (the centered-content look). */
  .card-media {
    display: block;
    margin: 0;
    overflow: hidden;
    aspect-ratio: 16 / 9;
    & > :is(img, video, picture, svg) {
      display: block;
      width: 100%;
      height: 100%;
      object-fit: cover;
    }
    &[data-inset] {
      margin: var(--_pad) var(--_pad) 0;
      border-radius: var(--radius-lg);
    }
    &[data-inset]:last-child {
      margin: 0 var(--_pad) var(--_pad);
    }
  }
  /* -- Density --------------------------------------------------
     data-density on the .card root scales the section paddings together.
     Scale matches sizing.css data-density (0.75 / 1 / 1.25): comfortable is
     the unsized default (1.5rem), compact 1rem, spacious 2rem; the
     header+footer-only gap (1rem base) follows the ratio (0.75 / 1 / 1.5). */
  .card:where([data-density="compact"]) { --_k: calc(2 / 3); --_kh: 0.75; }
  .card:where([data-density="comfortable"]) { --_k: 1; --_kh: 1; }
  .card:where([data-density="spacious"]) { --_k: calc(4 / 3); --_kh: 1.5; }
  .card {
    /* -- Sizes: padding + type scale together (md == the default) ----- */
    &[data-size="xs"] { --_base: 0.75rem; --_hfb: 0.5rem; --_title: 0.875rem; --_desc: 0.75rem; }
    &[data-size="sm"] { --_base: 1rem; --_hfb: 0.75rem; --_title: 1rem; --_desc: 0.8125rem; }
    &[data-size="md"] { --_base: 1.5rem; --_hfb: 1rem; --_title: 1.25rem; --_desc: 0.875rem; }
    &[data-size="lg"] { --_base: 2rem; --_hfb: 1.25rem; --_title: 1.5rem; --_desc: 1rem; }
    &[data-size="xl"] { --_base: 2.5rem; --_hfb: 1.5rem; --_title: 1.875rem; --_desc: 1.0625rem; }
    /* -- Variants -------------------------------------------------- */
    &[data-variant="outline"] { background-color: transparent; }
    &[data-variant="dashed"] { border-style: dashed; border-width: 2px; }
    &[data-variant="ghost"] { background-color: transparent; border-color: transparent; }
    &[data-variant="muted"] { background-color: var(--muted); border-color: transparent; }
    &[data-variant="elevated"] { border-color: transparent; box-shadow: var(--shadow-lg); }
    &[data-variant="primary"] {
      background-color: var(--primary);
      color: var(--primary-foreground);
      border-color: transparent;
      & .card-description { color: color-mix(in oklch, var(--primary-foreground) 78%, transparent); }
    }
    /* a charcoal surface: the inverse colors, softened (78%) so it stays
       apart from --primary - in the default theme primary IS near-black */
    &[data-variant="neutral"] {
      background-color: color-mix(in oklch, var(--foreground) 78%, var(--background));
      color: var(--background);
      border-color: transparent;
      & .card-description { color: color-mix(in oklch, var(--background) 72%, transparent); }
    }
    /* ghost / link buttons on a colored surface take its text color and a
       hover tint made from it (the default hover - the pale --accent - would
       put near-white text on near-white) */
    &:is([data-variant="primary"], [data-variant="neutral"], [data-layout="overlay"]) .btn:is([data-variant="ghost"], [data-variant="link"]) {
      color: inherit;
      &:hover { background-color: color-mix(in oklch, currentColor 16%, transparent); color: inherit; }
    }
    /* frosted: translucent card over whatever is behind it */
    &[data-variant="glass"] {
      background-color: color-mix(in oklch, var(--card) 55%, transparent);
      border-color: color-mix(in oklch, var(--foreground) 14%, transparent);
      backdrop-filter: blur(16px) saturate(1.4);
      box-shadow: 0 8px 32px -8px color-mix(in oklch, var(--foreground) 22%, transparent);
    }
    /* -- Centered content ------------------------------------------ */
    &[data-align="center"] {
      text-align: center;
      & .card-header { align-items: center; }
      & .card-footer { justify-content: center; }
    }
    /* -- Layouts ---------------------------------------------------
       side: media | body in one row, always (media after the body = image
       on the right). auto: side by side while the CARD is wide enough,
       stacked when it is not - the flex-wrap switch follows the card's own
       width, not the viewport, so the same card works in a sidebar and in a
       wide column. overlay: the media is the background, the body sits on
       a scrim at the bottom. */
    &[data-layout="side"] {
      display: grid;
      grid-template-columns: minmax(0, 2fr) minmax(0, 3fr);
      & > .card-media { aspect-ratio: auto; min-height: 100%; }
    }
    &[data-layout="side"]:has(> .card-body:first-child) {
      grid-template-columns: minmax(0, 3fr) minmax(0, 2fr);
    }
    &[data-layout="auto"] {
      display: flex;
      flex-wrap: wrap;
      & > .card-media { flex: 1 1 12rem; aspect-ratio: auto; min-height: 10rem; }
      & > .card-body { flex: 999 1 18rem; }
    }
    &[data-layout="overlay"] {
      display: grid;
      color: #fff;
      border-color: transparent;
      & > * { grid-area: 1 / 1; }
      & > .card-media { aspect-ratio: auto; min-height: 14rem; }
      & > .card-body {
        z-index: 1;
        align-self: end;
        background: linear-gradient(to top, oklch(0 0 0 / 0.78), oklch(0 0 0 / 0.35) 65%, transparent);
        padding-top: 3rem;
      }
      & .card-description { color: oklch(1 0 0 / 0.82); }
    }
    /* -- Interactive: a link (or [data-interactive]) card lifts on hover
       and shows a focus ring on keyboard focus ------------------------ */
    &:is(a, [data-interactive]) {
      display: block;
      text-decoration: none;
      transition: translate 150ms ease, box-shadow 150ms ease, border-color 150ms ease;
      &:hover { translate: 0 -2px; box-shadow: var(--shadow-md); border-color: color-mix(in oklch, var(--foreground) 22%, var(--border)); }
      &:focus-visible { outline: 2px solid var(--ring); outline-offset: 2px; }
    }
    &:is(a, [data-interactive])[data-layout="auto"] { display: flex; }
    &:is(a, [data-interactive]):is([data-layout="side"], [data-layout="overlay"]) { display: grid; }
    /* -- Selectable: a <label class="card"> around a checkbox / radio -
       the checked card takes a primary ring; keyboard focus shows too */
    &:is(label) {
      display: block;
      cursor: pointer;
      transition: border-color 150ms ease, box-shadow 150ms ease;
      &:has(:is(input[type="checkbox"], input[type="radio"]):checked) {
        border-color: var(--primary);
        box-shadow: 0 0 0 1px var(--primary);
      }
      &:has(input:focus-visible) { outline: 2px solid var(--ring); outline-offset: 2px; }
      &:has(input:disabled) { cursor: not-allowed; opacity: 0.55; }
    }
  }
  /* -- Container query: compact card in narrow containers - unless the
     card asks for a size (an explicit data-size wins) -- */
  @container (max-width: 280px) {
    .card:not([data-size]) :is(.card-header, .card-content, .card-footer) { --_pad: 1rem; }
    .card:not([data-size]) .card-title { font-size: 1rem; }
  }
  /* -- Accessibility ------------------------------------------ */
  @media (prefers-reduced-motion: reduce) {
    .card:is(a, [data-interactive]) { transition: none; }
    .card:is(a, [data-interactive]):hover { translate: none; }
  }
  @media (forced-colors: active) {
    .card:is(label):has(:is(input[type="checkbox"], input[type="radio"]):checked) { border: 2px solid Highlight; }
  }
}

Comments, ideas or improvements? Edit this page's source on GitHub