Skip to content
Back

Chip groupPro

Filter chips that morph as you pick them: a check grows in, the label slides, long sets fold behind +N more and selected chips never hide.

oxyn add chip-group
The code is part of Oxyn Pro

The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.

Get Pro

Rendered from Rust at build time · goes live when visible

When to use

  • Filter sources, topics or statuses; the mode chips under a composer.

When not to use

  • Switch the agent between Ask, Plan and Agent: use Mode switch instead.
  • Grouped filters with removable chips, collapsible checkbox groups, Clear all and full keyboard control: use Filter Menu instead.
  • A small status label that carries the colour: use Badge instead.

Installation

Chip group is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.

Terminal
oxyn add chip-group

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Examples

Filters

Source filters folding behind +N more.

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Single

Single choice that can still clear.

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Soft

Soft chips with counts (Oxyn plus).

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

ChipGroup

PropTypeDefaultDescription
optionsrequiredVec<(String, String)>—(value, label).
labelrequiredString—Group name.
valueVec<String>Default::default()Selected.
multiplebooltrueSeveral at once.
max_visibleusizeDefault::default()Visible before folding (0 = all).
countsVec<u32>Default::default()Count per option (same order).
variantString"outline"`outline` · `soft`.
clearableboolDefault::default()Clear chip when something is selected.
on_changeEventHandler<Vec<String>>—New selection.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
ArrowsBetween chips, wrapping
HomeorEndFirst / last
EnterorSpaceToggle or open the overflow

Accessibility

  • group with aria-label; chips are buttons with aria-pressed.
  • Selected chips always stay visible.
From the spec

group + aria-label; chips are buttons with aria-pressed; roving focus wraps; checks are decorative.

Motion & interaction

Selecting grows a check in and slides the label over; the chip edge springs. Revealed chips stagger in.

Timing
TransitionDurationEasingReduced motion
Check grow200 msease.outinstant
Colour120 mslinearinstant

Responsive behaviour

  • Chips wrap onto new lines.
Edge cases (spec)

Chips wrap; selected chips beyond max_visible stay in view so a filter is never hidden.

Notes for AI

  • Import ChipGroup from oxyn_dioxus and include PRIMITIVES_CSS plus the token stylesheet once.
  • A GPUI version exists: ChipGroupEl in oxyn_gpui.
  • Props to set first: options, label.
  • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI