MindeesUI
ComponentsForms

MultiSelect

A multi-choice dropdown that toggles options in a modal and summarises selections as a count or chips.

MultiSelect lets the user pick several values from a modal list, toggling each on tap. The trigger shows an N selected summary by default, or removable chips when showChips is set. It reads FormField context for invalid, disabled, and labelling.

Import

import { MultiSelect } from '@mindees/ui';

Usage

<MultiSelect
  options={tags}
  value={selected}
  onChange={setSelected}
  showChips
  placeholder="Pick tags"
/>

Props

PropTypeDefaultDescription
optionsreadonly SelectOption[]Options to choose from ({ label, value }).
valuereadonly string[][]Currently selected values.
onChange(value: string[]) => voidFired with the full next array of selected values.
placeholderstring'Select…'Shown on the trigger when nothing is selected.
showChipsbooleanfalseRender selected items as removable chips instead of a count.
disabledbooleaninheritedForce a disabled state outside of a FormField.
invalidbooleaninheritedForce an invalid state outside of a FormField.
styleStyleProp<ViewStyle>Style applied to the trigger container.

Accessibility

The trigger is a button with disabled/expanded state and forwards FormField labelling. Each option row is a checkbox exposing its checked state, and chips expose a remove affordance.

On this page