Playground

Multi select

Type to filter a list and pick several options, shown as removable tags.

  • Built on native elements
  • ARIA 1.2 combobox with a listbox that has aria-multiselectable; options carry aria-selected.
  • ArrowDown/ArrowUp move, Enter toggles the active option, Escape closes, Tab leaves.
  • Backspace in an empty field removes the last tag; each tag has a button named "Remove <label>".
  • Styles in one file: 03-form-fields.css

Import

import '@monoline/css';
import {MultiSelect} from '@monoline/react';

Not installed yet? Pick a route.

Copies the source and its styles into your project.

npx monoline add multi-select

Usage

import {Field, MultiSelect} from '@monoline/react';

const options = ['Ada Lovelace', 'Grace Hopper', 'Alan Turing', 'Katherine Johnson', 'Linus Torvalds'].map((n) => ({value: n.toLowerCase().replace(/\W+/g, '-'), label: n}));

<div style={{maxWidth: '360px', minHeight: '280px'}}>
  <Field label="People">
    <MultiSelect
      options={options}
      placeholder="Type a name"
      defaultValue={['ada-lovelace']}
    />
  </Field>
</div>

Examples

Pick several

Props

MultiSelectProps

PropTypeDefaultDescription
options requiredMultiSelectOption[]–The choices, each with a `value`, a `label` and an optional `disabled`. The user filters them by typing part of the label.
valuestring[]–The chosen option values when controlled. Pair with `onValueChange`.
defaultValuestring[][]The initially chosen option values when uncontrolled. Default empty.
onValueChange((value: string[]) => void)–Called with the full list of chosen values.
emptyTextstring'No matches'Shown when nothing matches.
size"sm" | "md" | "lg"'md'`md` (default), `sm` for dense layouts or `lg` for prominent forms. Heights match Button, Input and Select at each size.
invalidboolean–Marks the field as having an error: sets `aria-invalid` and shows the error border.

Data Attributes

State is exposed through attributes. Style it with these selectors, not with class toggles.

AttributeStylesheet
[aria-checked="true"]03-form-fields.css
[aria-invalid="true"]03-form-fields.css
[aria-pressed="true"]03-form-fields.css
[aria-disabled="true"]multi-select.css
[aria-selected="true"]multi-select.css
[data-active]multi-select.css
[data-disabled]multi-select.css
[data-invalid]multi-select.css
[data-size="lg"]multi-select.css
[data-size="sm"]multi-select.css

CSS classes

ClassStylesheet
.field03-form-fields.css
.field-hint03-form-fields.css
.input03-form-fields.css
.input-bare03-form-fields.css
.input-end03-form-fields.css
.input-lg03-form-fields.css
.input-sm03-form-fields.css
.input-wrap03-form-fields.css
.muted03-form-fields.css
.seg03-form-fields.css
.seg-opt03-form-fields.css
.select03-form-fields.css
.setting03-form-fields.css
.switch03-form-fields.css
.textarea03-form-fields.css
.avatar19-avatar.css
.avatar-group19-avatar.css
.avatar-lg19-avatar.css
.avatar-line19-avatar.css
.avatar-sm19-avatar.css
.stat19-avatar.css
.stat-note19-avatar.css
.stat-value19-avatar.css
.tag19-avatar.css
.multi-selectmulti-select.css
.multi-select-boxmulti-select.css
.multi-select-emptymulti-select.css
.multi-select-inputmulti-select.css
.multi-select-listmulti-select.css
.multi-select-optionmulti-select.css

Customization

Style it with the kit's tokens in your own CSS, loaded after @monoline/css. Prefer the attributes above over extra classes. See Theming for every token.

app.css
.field {
  border-color: var(--accent);
}
.field[aria-checked="true"] {
  background: var(--wash);
}

Accessibility

  • ARIA 1.2 combobox with a listbox that has aria-multiselectable; options carry aria-selected.
  • ArrowDown/ArrowUp move, Enter toggles the active option, Escape closes, Tab leaves.
  • Backspace in an empty field removes the last tag; each tag has a button named "Remove <label>".

Keyboard

KeysAction
ArrowDown / ArrowUpMove
EnterToggles the active option
EscapeCloses
TabLeaves
BackspaceIn an empty field removes the last tag