Skip to content
Theme

Tag group

A set of tags: removable, selectable, or both.

Examples

Removable
Topics
complexity
verification
benchmarks
Backspace removes the focused tag.
Selectable, with tones
Open
Passed
Failed

Props

TagGroup

A set of tags. Arrow keys move between them; with onRemove, Backspace or Delete removes one; with a selectionMode, Space selects.

PropTypeDefaultDescription
labelstring—Names the group for screen readers; shown when `showLabel` is set.
showLabel?booleanfalse
description?ReactNode—
items?Iterable<T>—
childrenReactNode | ((item: T) => ReactNode)—

Also takes 88 props it passes to the underlying React Aria component or element (events, ARIA attributes, state such as isDisabled), documented by React Aria.

Tag

PropTypeDefaultDescription
tone?Tone"neutral"
childrenReactNode—

Also takes 94 props it passes to the underlying React Aria component or element (events, ARIA attributes, state such as isDisabled), documented by React Aria.

Keyboard

KeyDoes
ArrowLeft or ArrowRightMove between tags
Backspace or DeleteRemoves the focused tag, when removable
SpaceSelects the focused tag, when selectable

Accessibility

  • The group is one tab stop; the label names it even when it is not shown.