@manufosela/data-card

A versatile card web component for displaying data with optional cover image, icon, links, and modal info, built with Lit

← Back to components GitHub Repo Playground

Basic Usage

Simple card with title and description

<data-card
  card-title="Welcome"
  description="A simple data card with basic content."
></data-card>

With Icon

Card with an emoji or character as icon

<data-card
  card-title="Settings"
  description="Configure your preferences."
  icon="⚙️"
></data-card>

With Cover Image

Card with a cover image header

<data-card
  card-title="Mountain View"
  description="Beautiful landscape photography."
  img-cover="https://example.com/image.jpg"
></data-card>

With Group Badge

Card categorized with a group label

<data-card
  card-title="React Tutorial"
  description="Learn React from scratch."
  icon="📚"
  group="Tutorial"
></data-card>

Clickable Card

Card that links to a URL

<data-card
  card-title="Visit GitHub"
  description="Check out the source code."
  icon="🔗"
  url="https://github.com/..."
  newtab
></data-card>

With Slotted Content

Card with custom HTML content via slots

Tag 1 Tag 2

<data-card card-title="Custom Content" icon="✨">
  <div>
    <span class="tag">Tag 1</span>
    <span class="tag">Tag 2</span>
  </div>
</data-card>

Card Gallery

Multiple cards with different styles

<data-card card-title="Documents" icon="📄" group="Files"></data-card>
<data-card card-title="Analytics" img-cover="..." group="Data"></data-card>
<data-card card-title="Messages" icon="💬"></data-card>

Custom Styling

Customize with CSS variables

<data-card
  card-title="Styled Card"
  icon="🎨"
  style="
    --data-card-bg: #1e293b;
    --data-card-title-color: #f8fafc;
    --data-card-desc-color: #94a3b8;
    --data-card-icon-color: #f472b6;
  "
></data-card>

Cover Background

Card with colored background in cover area

<data-card
  card-title="Gradient Card"
  icon="🌈"
  cover-bg-color="linear-gradient(135deg, #667eea, #764ba2)"
></data-card>

Demo code (CodePen-ready HTML, CSS, JS)

HTML (html)

<div class="container">
      

      <div class="demo-grid">
        <!-- Basic Usage -->
        <div class="demo-section">
          <h2>Basic Usage</h2>
          <p>Simple card with title and description</p>
          <div class="demo-content">
            <data-card
              card-title="Welcome"
              description="A simple data card with basic content."
            ></data-card>
          </div>
          <div class="code-block">&lt;data-card
  card-title="Welcome"
  description="A simple data card with basic content."
&gt;&lt;/data-card&gt;</div>
        </div>

        <!-- With Icon -->
        <div class="demo-section">
          <h2>With Icon</h2>
          <p>Card with an emoji or character as icon</p>
          <div class="demo-content">
            <data-card
              card-title="Settings"
              description="Configure your preferences and options."
              icon="⚙️"
            ></data-card>
          </div>
          <div class="code-block">&lt;data-card
  card-title="Settings"
  description="Configure your preferences."
  icon="⚙️"
&gt;&lt;/data-card&gt;</div>
        </div>

        <!-- With Cover Image -->
        <div class="demo-section">
          <h2>With Cover Image</h2>
          <p>Card with a cover image header</p>
          <div class="demo-content">
            <data-card
              card-title="Mountain View"
              description="Beautiful landscape photography from the Alps."
              img-cover="https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=400&h=200&fit=crop"
            ></data-card>
          </div>
          <div class="code-block">&lt;data-card
  card-title="Mountain View"
  description="Beautiful landscape photography."
  img-cover="https://example.com/image.jpg"
&gt;&lt;/data-card&gt;</div>
        </div>

        <!-- With Group Badge -->
        <div class="demo-section">
          <h2>With Group Badge</h2>
          <p>Card categorized with a group label</p>
          <div class="demo-content">
            <data-card
              card-title="React Tutorial"
              description="Learn React from scratch with this comprehensive guide."
              icon="📚"
              group="Tutorial"
            ></data-card>
          </div>
          <div class="code-block">&lt;data-card
  card-title="React Tutorial"
  description="Learn React from scratch."
  icon="📚"
  group="Tutorial"
&gt;&lt;/data-card&gt;</div>
        </div>

        <!-- With Link -->
        <div class="demo-section">
          <h2>Clickable Card</h2>
          <p>Card that links to a URL</p>
          <div class="demo-content">
            <data-card
              card-title="Visit GitHub"
              description="Check out the source code repository."
              icon="🔗"
              url="https://github.com/manufosela/ui-components"
              newtab
            ></data-card>
          </div>
          <div class="code-block">&lt;data-card
  card-title="Visit GitHub"
  description="Check out the source code."
  icon="🔗"
  url="https://github.com/..."
  newtab
&gt;&lt;/data-card&gt;</div>
        </div>

        <!-- With Slotted Content -->
        <div class="demo-section">
          <h2>With Slotted Content</h2>
          <p>Card with custom HTML content via slots</p>
          <div class="demo-content">
            <data-card
              card-title="Custom Content"
              description="This card has additional slotted content."
              icon="✨"
            >
              <div style="display: flex; gap: 8px; margin-top: 8px;">
                <span style="background: #dbeafe; color: #1e40af; padding: 4px 8px; border-radius: 4px; font-size: 12px;">Tag 1</span>
                <span style="background: #dcfce7; color: #166534; padding: 4px 8px; border-radius: 4px; font-size: 12px;">Tag 2</span>
              </div>
            </data-card>
          </div>
          <div class="code-block">&lt;data-card card-title="Custom Content" icon="✨"&gt;
  &lt;div&gt;
    &lt;span class="tag"&gt;Tag 1&lt;/span&gt;
    &lt;span class="tag"&gt;Tag 2&lt;/span&gt;
  &lt;/div&gt;
&lt;/data-card&gt;</div>
        </div>

        <!-- Multiple Cards -->
        <div class="demo-section wide-section">
          <h2>Card Gallery</h2>
          <p>Multiple cards with different styles</p>
          <div class="demo-content cards-row">
            <data-card
              card-title="Documents"
              description="Access your files and documents."
              icon="📄"
              group="Files"
              style="--data-card-icon-color: #f59e0b;"
            ></data-card>

            <data-card
              card-title="Analytics"
              description="View your performance metrics."
              img-cover="https://images.unsplash.com/photo-1551288049-bebda4e38f71?w=400&h=200&fit=crop"
              group="Data"
              style="--data-card-group-bg: #8b5cf6;"
            ></data-card>

            <data-card
              card-title="Messages"
              description="Check your inbox and notifications."
              icon="💬"
              style="--data-card-icon-color: #10b981;"
            ></data-card>
          </div>
          <div class="code-block">&lt;data-card card-title="Documents" icon="📄" group="Files"&gt;&lt;/data-card&gt;
&lt;data-card card-title="Analytics" img-cover="..." group="Data"&gt;&lt;/data-card&gt;
&lt;data-card card-title="Messages" icon="💬"&gt;&lt;/data-card&gt;</div>
        </div>

        <!-- Custom Styling -->
        <div class="demo-section">
          <h2>Custom Styling</h2>
          <p>Customize with CSS variables</p>
          <div class="demo-content">
            <data-card
              card-title="Styled Card"
              description="This card uses custom CSS variables."
              icon="🎨"
              style="
                --data-card-bg: #1e293b;
                --data-card-title-color: #f8fafc;
                --data-card-desc-color: #94a3b8;
                --data-card-border-color: #334155;
                --data-card-icon-color: #f472b6;
              "
            ></data-card>
          </div>
          <div class="code-block">&lt;data-card
  card-title="Styled Card"
  icon="🎨"
  style="
    --data-card-bg: #1e293b;
    --data-card-title-color: #f8fafc;
    --data-card-desc-color: #94a3b8;
    --data-card-icon-color: #f472b6;
  "
&gt;&lt;/data-card&gt;</div>
        </div>

        <!-- Cover Background Color -->
        <div class="demo-section">
          <h2>Cover Background</h2>
          <p>Card with colored background in cover area</p>
          <div class="demo-content">
            <data-card
              card-title="Gradient Card"
              description="Card with a custom cover background."
              icon="🌈"
              cover-bg-color="linear-gradient(135deg, #667eea 0%, #764ba2 100%)"
              style="--data-card-icon-color: #ffffff;"
            ></data-card>
          </div>
          <div class="code-block">&lt;data-card
  card-title="Gradient Card"
  icon="🌈"
  cover-bg-color="linear-gradient(135deg, #667eea, #764ba2)"
&gt;&lt;/data-card&gt;</div>
        </div>
      </div>

      
    </div>

CSS (css)

:root {
  --bg: #0c0f14;
  --bg-elevated: #141923;
  --bg-panel: #171d28;
  --border: #262f3f;
  --text: #f4f6fb;
  --text-muted: #a7b0c2;
  --text-dim: #7d879b;
  --accent: #ff8a3d;
  --accent-strong: #ff6a00;
  --accent-soft: rgba(255, 138, 61, 0.16);
  --shadow: 0 20px 50px rgba(5, 8, 14, 0.45);
  --radius-lg: 22px;
  --radius-md: 14px;
  --radius-sm: 10px;
  --max-width: 1160px;
}

:root {
        --bg-color: #f5f5f7;
        --card-bg: #ffffff;
        --text-color: #1d1d1f;
        --text-muted: #86868b;
        --border-color: #d2d2d7;
      }

      * {
        box-sizing: border-box;
      }

      .container {
        max-width: 1200px;
        margin: 0 auto;
      }

      header {
        text-align: center;
        margin-bottom: 3rem;
      }

      h1 {
        font-size: 2.5rem;
        font-weight: 600;
        margin-bottom: 0.5rem;
      }

      .subtitle {
        color: var(--text-muted);
        font-size: 1.1rem;
      }

      .demo-grid {
        display: grid;
        grid-template-columns: repeat(auto-fit, minmax(320px, 1fr));
        gap: 2rem;
      }

      .demo-section {
        background: var(--card-bg);
        border-radius: 16px;
        padding: 2rem;
        box-shadow: 0 4px 6px rgba(0, 0, 0, 0.05);
      }

      .demo-section h2 {
        font-size: 1.25rem;
        font-weight: 600;
        margin: 0 0 0.5rem 0;
      }

      .demo-section > p {
        color: var(--text-muted);
        font-size: 0.9rem;
        margin: 0 0 1.5rem 0;
      }

      .demo-content {
        display: flex;
        flex-wrap: wrap;
        gap: 1.5rem;
        justify-content: center;
        margin-bottom: 1.5rem;
      }

      .code-block {
        background: #1d1d1f;
        color: #f5f5f7;
        padding: 1rem;
        border-radius: 8px;
        font-family: 'SF Mono', Monaco, monospace;
        font-size: 0.75rem;
        overflow-x: auto;
        white-space: pre-wrap;
        word-break: break-word;
      }

      footer {
        text-align: center;
        margin-top: 3rem;
        padding-top: 2rem;
        border-top: 1px solid var(--border-color);
        color: var(--text-muted);
        font-size: 0.9rem;
      }

      footer a {
        color: var(--text-color);
        text-decoration: none;
      }

      footer a:hover {
        text-decoration: underline;
      }

      .wide-section {
        grid-column: 1 / -1;
      }

      .cards-row {
        display: flex;
        flex-wrap: wrap;
        gap: 1.5rem;
        justify-content: center;
      }

      /* Sample more-info content file */
      .info-sample {
        display: none;
      }
    


@import url('https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;600;700&display=swap');

:root {
  --bg: #f5f5f7;
  --bg-2: #ffffff;
  --bg-spot-1: #f8e9d0;
  --bg-spot-2: #e8eef8;
  --card: #ffffff;
  --text: #1d1d1f;
  --muted: #6b7280;
  --line: #e5e7eb;
  --accent: #ffb000;
  --accent-2: #00a7d6;
  --accent-soft: rgba(255, 176, 0, 0.18);
  --surface-1: #f3f4f6;
  --surface-2: #eef2f7;
  --code-bg: #111827;
  --code-text: #f9fafb;
  --panel-bg: rgba(255, 255, 255, 0.85);
  --overlay-bg: rgba(255, 255, 255, 0.98);
}

:root.dark {
  --bg: #0f1117;
  --bg-2: #151a26;
  --bg-spot-1: #1a2136;
  --bg-spot-2: #1d1b34;
  --card: #1c2233;
  --text: #f3f6ff;
  --muted: #b8c0d9;
  --line: #2b3247;
  --accent: #ffb000;
  --accent-2: #00d0ff;
  --accent-soft: rgba(255, 176, 0, 0.25);
  --surface-1: #0b0f1a;
  --surface-2: #263046;
  --code-bg: #0b0f1a;
  --code-text: #d6d9e6;
  --panel-bg: rgba(28, 34, 51, 0.8);
  --overlay-bg: rgba(15, 17, 23, 0.98);
}

* {
  box-sizing: border-box;
}

a {
  color: var(--accent);
}

h1 {
  color: var(--accent);
}

.demo-links {
  margin-top: 12px;
  display: flex;
  gap: 12px;
  justify-content: center;
  flex-wrap: wrap;
}

.demo-links a {
  border: 1px solid var(--line);
  border-radius: 999px;
  padding: 6px 12px;
  color: var(--muted);
  text-decoration: none;
  font-size: 0.85rem;
  transition: border-color 0.2s ease, color 0.2s ease;
}

.demo-links a:hover {
  color: var(--text);
  border-color: var(--accent-2);
}

.demo-theme-toggle {
  margin-top: 12px;
  display: flex;
  justify-content: center;
}

header {
  border-bottom: 1px solid var(--line);
}

.demo-card,
.section,
.demo-section,
.panel,
.card {
  background: var(--card);
  border: 1px solid var(--line);
  border-radius: 16px;
  color: var(--text);
  box-shadow: 0 18px 36px rgba(6, 10, 24, 0.45);
}

.demo-card {
  display: flex;
  flex-direction: column;
  gap: 12px;
}

.demo-card .code-block {
  margin-top: auto;
}

.demo-grid,
.grid {
  align-items: stretch;
}

.demo-card h2,
.demo-card h3,
.section h2,
.demo-section h2,
.panel-header {
  color: var(--text);
}

.label,
.stat-label,
.category-title,
.subtitle,
.hint,
.note {
  color: var(--muted);
}

.info-item,
.capability,
.preference,
.option-group,
.output,
.current-url,
.event-log,
.result-card,
.log,
.stat {
  background: var(--surface-1);
  border: 1px solid var(--line);
  color: var(--text);
}

.info-item .label,
.capability .name {
  color: var(--muted);
}

.panel-header,
.options,
.topbar,
.top-links {
  background: var(--panel-bg);
  border-bottom: 1px solid var(--line);
  color: var(--text);
}

.subtitle,
.hint,
.note,
.demo-card p,
.section p,
.demo-section p {
  color: var(--muted);
}

.code-block,
pre,
code {
  background: var(--code-bg);
  color: var(--code-text);
  border-radius: 8px;
}

.value-display,
.output,
.result,
.demo-output {
  background: var(--surface-1);
  border: 1px solid var(--line);
  color: var(--text);
}

button {
  background: linear-gradient(120deg, var(--accent), #ff6a00);
  color: #111;
  border: none;
}

button:hover {
  filter: brightness(1.05);
}

input,
select,
textarea {
  background: var(--surface-1);
  color: var(--text);
  border: 1px solid var(--line);
}

footer {
  color: var(--muted);
}

footer a {
  color: var(--text);
}

arc-slider {
  --arc-slider-text-color: var(--text);
  --arc-slider-value-bg: var(--surface-1);
  --arc-slider-value-border: var(--line);
  --arc-slider-value-shadow: 0 6px 16px rgba(0, 0, 0, 0.35);
}

rich-select {
  --caller-background: var(--card);
  --caller-color: var(--text);
  --caller-border: 1px solid var(--line);
  --caller-hover-background: var(--surface-2);
  --caller-hover-color: var(--text);
  --caller-hover-border-color: var(--line);
  --caller-focus-border-color: var(--accent-2);
  --caller-focus-shadow: 0 0 0 3px rgba(0, 208, 255, 0.25);
  --caller-disabled-background: var(--surface-1);
  --caller-disabled-color: #6b7280;
  --caller-disabled-border-color: var(--line);
  --arrow-color: var(--muted);
  --selectOptions-background: var(--card);
  --selectOptions-border: 1px solid var(--line);
  --selectOptions-shadow: 0 10px 22px rgba(0, 0, 0, 0.45);
  --input-background: var(--surface-1);
  --input-border: 1px solid var(--line);
  --input-color: var(--text);
  --input-placeholder-color: #6b7280;
  --option-color: var(--text);
  --option-hover-background: var(--surface-2);
  --option-hover-color: var(--text);
  --option-active-background: var(--accent);
  --option-active-color: #111;
  --option-selected-background: var(--accent-soft);
  --option-selected-color: var(--text);
  --option-disabled-background: var(--surface-1);
  --option-disabled-color: #6b7280;
}

multi-select {
  --multi-select-bg: var(--card);
  --multi-select-border-color: var(--line);
  --multi-select-border-hover: var(--line);
  --multi-select-border-focus: var(--accent-2);
  --multi-select-text-color: var(--text);
  --multi-select-placeholder-color: #6b7280;
  --multi-select-arrow-color: var(--muted);
  --multi-select-dropdown-bg: var(--card);
  --multi-select-shadow: 0 10px 22px rgba(0, 0, 0, 0.45);
  --multi-select-option-hover-bg: var(--surface-2);
  --multi-select-option-selected-bg: var(--accent-soft);
}

tab-nav {
  --tab-bg: var(--card);
  --tab-border: var(--line);
  --tab-text: var(--muted);
  --tab-active-text: var(--text);
  --tab-hover-bg: var(--surface-2);
  --tab-active-border: var(--accent);
  --tab-disabled: #9ca3af;
}

slider-underline {
  --slider-track: var(--surface-2);
  --slider-fill: var(--accent);
  --slider-thumb: var(--accent);
  --slider-label-color: var(--text);
  --slider-tick-color: #9ca3af;
  --slider-tick-value-color: var(--muted);
}

header-nav {
  --header-bg: var(--card);
  --header-shadow: 0 12px 24px rgba(0, 0, 0, 0.2);
  --header-link-color: var(--text);
  --header-link-hover: var(--accent);
  --header-mobile-hover-bg: var(--surface-2);
}

calendar-inline {
  --calendar-bg: var(--card);
  --calendar-shadow: 0 12px 24px rgba(0, 0, 0, 0.2);
  --calendar-text: var(--text);
  --calendar-accent: var(--accent);
  --calendar-today: var(--accent-soft);
  --calendar-selected: var(--accent);
  --calendar-hover-bg: var(--surface-2);
  --calendar-muted: var(--muted);
  --calendar-muted-strong: #9ca3af;
  --calendar-other-month: #9ca3af;
  --calendar-disabled: #cbd5e1;
  --calendar-holiday: #ef4444;
  --calendar-holiday-selected: #111;
}

marked-calendar {
  --calendar-bg: var(--card);
  --calendar-border: var(--line);
  --calendar-title: var(--text);
  --calendar-muted: var(--muted);
  --calendar-surface: var(--surface-1);
  --calendar-accent: var(--accent);
  --calendar-accent-hover: #ff7a1a;
  --calendar-border-strong: var(--line);
  --calendar-contrast: #111;
  --calendar-nav-bg: var(--surface-1);
  --calendar-nav-hover: var(--surface-2);
}

radar-chart {
  --radar-bg: var(--card);
  --radar-grid-color: var(--line);
  --radar-axis-color: #94a3b8;
  --radar-label-color: var(--muted);
}

multi-carousel {
  --carousel-bg: var(--card);
  --carousel-arrow-bg: var(--surface-1);
  --carousel-arrow-color: var(--text);
  --carousel-arrow-hover-bg: var(--surface-2);
  --carousel-arrow-hover-color: var(--text);
  --carousel-nav-bg: var(--surface-1);
  --carousel-nav-color: var(--muted);
  --carousel-nav-hover: #9ca3af;
  --carousel-nav-active: var(--accent);
  --carousel-focus-color: var(--accent-2);
}

nav-list {
  --nav-list-bg: var(--card);
  --nav-list-border-color: var(--line);
  --nav-list-selected-border-color: var(--accent);
  --nav-list-selected-bg: var(--surface-2);
  --nav-list-hover-bg: var(--surface-2);
  --nav-list-selected-color: var(--text);
}

theme-toggle {
  --theme-toggle-bg: var(--card);
  --theme-toggle-icon-color: var(--muted);
  --theme-toggle-hover-bg: var(--surface-2);
  --theme-toggle-active-bg: var(--surface-1);
  --theme-toggle-active-color: var(--text);
  --theme-toggle-dark-bg: var(--card);
  --theme-toggle-dark-border: var(--line);
  --theme-toggle-dark-icon-color: var(--muted);
  --theme-toggle-dark-active-bg: var(--surface-1);
  --theme-toggle-dark-active-color: var(--text);
  --theme-toggle-dark-hover-bg: var(--surface-2);
}

qr-code {
  --qr-fg: #0f1117;
  --qr-bg: #f3f6ff;
}

click-clock {
  --clock-color: var(--text);
  --clock-bg: var(--card);
  --clock-muted-color: var(--muted);
}

historical-line {
  --title-color: var(--text);
  --border-color: var(--line);
  --year-bg: var(--surface-1);
}

circle-steps {
  --steps-muted: var(--muted);
  --steps-text: var(--text);
  --steps-pending: var(--surface-2);
}

rich-inputfile {
  --input-border: var(--line);
  --input-border-focus: var(--accent-2);
  --input-bg: var(--card);
  --input-label-color: var(--text);
  --input-hover-bg: var(--surface-2);
  --input-drag-bg: var(--accent-soft);
  --input-disabled-bg: var(--surface-1);
  --input-success-border: #22c55e;
  --input-success-bg: rgba(34, 197, 94, 0.12);
  --input-icon-color: #94a3b8;
  --input-text-color: var(--muted);
  --input-accent-color: var(--accent-2);
  --input-file-bg: var(--surface-1);
  --input-preview-bg: var(--surface-1);
  --input-file-name-color: var(--text);
  --input-file-size-color: var(--muted);
  --input-error-color: #ef4444;
  --input-hint-color: var(--muted);
}

data-card {
  --data-card-bg: var(--card);
  --data-card-border-color: var(--line);
  --data-card-title-color: var(--text);
  --data-card-desc-color: var(--muted);
  --data-card-info-bg: var(--overlay-bg);
  --data-card-info-close-bg: var(--surface-2);
  --data-card-info-close-color: var(--text);
  --data-card-info-close-hover-bg: var(--surface-1);
  --data-card-info-text: var(--text);
  --data-card-loading-color: var(--muted);
  --data-card-info-trigger-hover: var(--accent);
}

app-modal {
  --app-modal-bg: var(--card);
  --app-modal-body-color: var(--text);
  --app-modal-standalone-bg: rgba(255, 176, 0, 0.35);
  --app-modal-standalone-color: #111;
  --app-modal-standalone-hover-bg: rgba(255, 176, 0, 0.6);
}

JS (js)

document.querySelectorAll('.footer-year').forEach(el => el.textContent = new Date().getFullYear());
    

      import "https://esm.sh/@manufosela/data-card";

      // Listen for card click events
      document.querySelectorAll('data-card').forEach(card => {
        card.addEventListener('data-card-click', (e) => {
          console.log('Card clicked:', e.detail);
        });
      });
    

  import '../../theme-toggle/src/theme-toggle.js';

  const root = document.documentElement;
  root.classList.add('dark');

  const toggle = document.querySelector('theme-toggle');
  if (toggle) {
    toggle.theme = root.classList.contains('dark') ? 'dark' : 'light';
    toggle.addEventListener('theme-changed', (event) => {
      const theme = event.detail?.theme;
      if (!theme) return;
      root.classList.toggle('dark', theme === 'dark');
    });
  }