Skip to content
Design System
GitHub

Chip group

v0.23.0

One choice among several as chips with counts, folded after N; or links, so a filter lives in the URL. Selected is inverted.

API reference

Generated from the types. Every part also takes className.

ChipGroup

itemsrequired
Chip[]
value
string
onValueChange
(value: string | undefined) => void
labelrequired
stringNames the group: "Task", "Saved views".
max
numberShow this many chips, then "N more".
allowNone
boolean = truePressing the selected chip clears the choice.
moreLabel
(hidden: number) => stringSame as labels.more, and wins over it.
lessLabel
stringSame as labels.less, and wins over it.
labels
Partial<ChipGroupLabels>The words it says, to translate them.
locale
stringFormats the counts (a BCP 47 tag such as "zh-TW"). Left out, the browser's language.
linkAs
ElementType = "a"Your router's link (e.g. next/link), for chips with href.