HeroUI Pro

Item Card Group

A layout component for grouping item cards in list or grid arrangements with section headers and dividers.

Usage

Grid

Grid Three Columns

Linked Accounts

List

Multiple Sections

Notification Preferences

Permission Levels

Pressable

Variants

Wallet List

With Header

CSS Classes

Base & Variant Classes

  • .item-card-group - Base group container with rounded corners
  • .item-card-group--default - Default variant with surface background and shadow
  • .item-card-group--secondary - Secondary variant with surface-secondary background
  • .item-card-group--tertiary - Tertiary variant with surface-tertiary background
  • .item-card-group--outline - Outline variant with border and transparent background
  • .item-card-group--transparent - Transparent variant with no background, shadow, or rounded corners

Layout Classes

  • .item-card-group--list - Vertical stack layout with auto-dividers between cards
  • .item-card-group--grid - Multi-column grid layout with spaced cards (column count via --item-card-group-columns)

Element Classes

  • .item-card-group__header - Optional section heading area
  • .item-card-group__title - Section heading text
  • .item-card-group__description - Section subtext

CSS Variables

  • --item-card-group-columns - Number of grid columns (default: 2, set via the columns prop)

API Reference

ItemCardGroup

The root component. Groups item cards with shared styling.

PropTypeDefaultDescription
layout'list' | 'grid''list'Layout mode
variant'default' | 'secondary' | 'tertiary' | 'outline' | 'transparent''default'Visual style variant
columns2 | 32Number of grid columns when layout is "grid"
childrenReactNode-Item cards, separators, and headers

Also supports all native div HTML attributes.

ItemCardGroup.Header

Optional section heading area.

PropTypeDefaultDescription
childrenReactNode-Title and description elements

Also supports all native div HTML attributes.

ItemCardGroup.Title

Section heading rendered as an h3.

PropTypeDefaultDescription
childrenReactNode-Title text

Also supports all native h3 HTML attributes.

ItemCardGroup.Description

Section subtext rendered as a p.

PropTypeDefaultDescription
childrenReactNode-Description text

Also supports all native p HTML attributes.

On this page