Chip

A compact interactive element for tags, filters, and selection states.

Installation

pnpm dlx stera-ui add chip

Usage

import { Chip } from "@/components/ui/chip"
<Chip>Label</Chip>

Variants

VariantDescription
subtleMuted background, no border (default)
outlineBordered with a surface background
solidStrong inverse background

Sizes

SizeDescription
xsExtra small (default)
smSmall
mdMedium
lgLarge

With Icons

Use data-icon="inline-start" or data-icon="inline-end" on an icon to control spacing and alignment.

<Chip variant="subtle" size="sm">
  <SiHash data-icon="inline-start" />
  Tag
</Chip>
 
<Chip variant="subtle" size="sm">
  Label
  <SiX data-icon="inline-end" />
</Chip>

Active State

Use the active prop to visually mark a chip as selected.

<Chip variant="subtle" active>Active</Chip>

API Reference

Built on Base UI's Button primitive. Renders as a <button> element.

PropTypeDefault
variant"subtle" | "outline" | "solid""subtle"
size"xs" | "sm" | "md" | "lg""xs"
activebooleanfalse
disabledbooleanfalse