Skip to content
Back

Multi-selectPro

Several values in a compact field: chips that grow in, a rolling +N, drawn checks in the list and a Clear button.

oxyn add multi-select
Search
Browser
Shell
Files
Calendar
Email
GitHub
The agent asks before using anything else
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

  • Several values in a compact field that looks like a select: which tools an agent may use, which repositories a run touches.
  • The user opens a list, ticks a few, and wants the trigger to stay one line tall.

When not to use

  • Pick one or many from a searchable, grouped list: use Combobox instead.
  • Pick one option in the text field's look: use Select instead.
  • A small status label that carries the colour: use Badge instead.

Installation

Multi-select 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 multi-select

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

Default

Three picked, two chips and +1.

Search
Browser
Shell
Files
Calendar
Email
GitHub
The agent asks before using anything else
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

Closed

Closed trigger.

The agent asks before using anything else
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

Select all

Select all row (Oxyn plus).

Select all 7
Search
Browser
Shell
Files
Calendar
Email
GitHub
The agent asks before using anything else
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

Capped

Max with a reason (Oxyn plus).

Search
Browser
Shell
Files
Calendar
Email
GitHub
The agent asks before using anything else
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

MultiSelect

PropTypeDefaultDescription
labelrequiredString—Label (also names the listbox).
optionsrequiredVec<ComboOption>—Options.
valueVec<String>Default::default()Starting values.
placeholderString"Select options"Placeholder.
descriptionOption<String>Default::default()Helper copy.
max_visibleusize2Chips before `+N`.
select_allboolDefault::default()Select all row.
max_selectedOption<usize>Default::default()Max picks.
openboolDefault::default()Start open (review sheets).
disabledboolDefault::default()Disabled.
on_changeEventHandler<Vec<String>>—Changed.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
EnterorSpaceOpen or close; Enter toggles the active option while open
↓or↑Open, then move through enabled options (wraps)
HomeorEndFirst / last option
EscClose

Accessibility

  • Trigger: aria-haspopup=listbox, aria-expanded, labelled by the label and a hidden list of the picked labels.
  • The menu is role=listbox with aria-multiselectable; options carry aria-selected and aria-disabled.
  • Clear is labelled “Clear selections”; chips are aria-hidden in favour of the spoken summary.
From the spec

The trigger is a button with aria-haspopup=listbox; its name is the label plus a visually hidden comma-joined list of picked labels (chips are aria-hidden). The menu is a listbox with aria-multiselectable; options carry aria-selected / aria-disabled. Changes are announced politely ("Added Shell, 3 selected").

Motion & interaction

Chips grow in from the left; +N rolls as the count changes; the box fills and its tick draws; the menu lifts in from the trigger. Clear collapses the chips together.

Timing
TransitionDurationEasingReduced motion
Chip grow200 msease.out1 ms
+N roll200 msease.outswap
Check220 ms fill + 240 ms drawease.outdrawn
Menu180 msease.out80 ms fade

Responsive behaviour

  • Chips cap at 9rem and ellipsize; max_visible keeps the trigger on one line.
  • The menu spans the field; keep lists short on small screens.
Edge cases (spec)

Chips cap at 9 rem with ellipsis; max_visible keeps the trigger one line. Everything disabled: the list shows but nothing toggles. Long lists scroll; the active row stays in view. Narrow screens: the menu spans the field.

Notes for AI

  • Import MultiSelect from oxyn_dioxus and include PRIMITIVES_CSS plus the token stylesheet once.
  • A GPUI version exists: ComboboxEl in oxyn_gpui.
  • Props to set first: label, options.
  • 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