Skip to content
hightouchUI

Design system

c6c48ee

Label chips

Label chips render grouped labels: read-only values are comma-separated and removable values have their own dismiss button. Values that do not fit collapse behind an in-chip "+N" popover.

Example

Usage

Removable values and overflow

Pass onRemoveLabel to make values removable. Give the chip a bounded width from its parent to collapse overflowing values.

A removable chip is interactive, so it takes a hover background and its "+N" opens on click. A read-only chip has no hover state, and its "+N" reveals the hidden values on hover or keyboard focus. Either way the "+N" panel lists its values as bubbles; a read-only one just leaves off the dismiss button.

A group name wider than its chip truncates, so the values keep their room.

Guidelines

When to use

  • When a resource's labels are organized into named groups and each group should read as one chip.
  • When values need inline removal.

When not to use

  • For a flat run of badges with no group structure, use a badge group.
  • For selecting labels, use a checkbox popover or multi-select.

Content

Props

LabelChips

NameDefaultDescription
groupedLabels

GroupedLabelChipValues[]One chip per entry, rendered in the given order. Entries with no labels are the caller's to drop.
size"md""sm" | "md"Chip size.
onRemoveLabel

(label: LabelChipValue, group: LabelChipGroup) => voidMakes values removable: every value carries a dismiss X.