Documentation menu
morphui Documentation

MorphMultiSelect

Chosen values stay in the field, and the field keeps its shape.

Live preview
Topics
Pick a topic. The field makes room for it.

Example

The same component used in the preview. Works in JSX and TSX.

MorphMultiSelect example
import { useState } from 'react';
import { MorphMultiSelect } from '@lestradavaz/morph-ui';
import './demo.css';

const topics = ['Animation', 'Accessibility', 'Design systems', 'React', 'TypeScript', 'Performance'];

export default function MultiSelectDemo() {
  const [value, setValue] = useState<string[]>(['Animation']);
  return (
    <MorphMultiSelect
      options={topics}
      value={value}
      onChange={setValue}
      label="Topics"
      aria-label="Search topics"
      placeholder="Choose topics"
    />
  );
}
Preview stylesheet demo.css
demo.css
.demo-primary,.demo-chip,.demo-card,.demo-close { font:inherit; cursor:pointer; border:0; }
.demo-primary { display:inline-flex; align-items:center; justify-content:center; min-height:48px; padding:0 25px; border-radius:999px; background:var(--morph-accent); color:var(--morph-on-accent); font-weight:500; font-size:15px; white-space:nowrap; }
.demo-chip { padding:14px 22px; border-radius:16px; background:var(--morph-chip); color:var(--morph-text); font-size:15px; }
.demo-primary:active,.demo-chip:active { transform:scale(.98); }
.demo-dialog-panel { width:min(460px,100%); height:min(650px,100%); border-radius:34px; }
.demo-window-panel { width:min(530px,100%); height:min(570px,100%); border-radius:34px; }
.demo-sheet { padding:60px 36px 32px; display:flex; flex-direction:column; gap:20px; }
.demo-sheet h2 { font-size:30px; line-height:1.2; letter-spacing:-.025em; margin:0; font-weight:550; }
.demo-sheet p { margin:0; color:var(--morph-muted); font-size:15px; line-height:1.65; }
.demo-sheet form { display:flex; flex-direction:column; gap:20px; }
.demo-sheet label { display:flex; flex-direction:column; gap:8px; font-size:14px; }
.demo-sheet input { width:100%; height:48px; padding:0 14px; color:var(--morph-text); background:var(--morph-surface); border:1px solid var(--morph-border); border-radius:10px; font:inherit; }
.demo-sheet input::placeholder { color:var(--morph-muted); }
.demo-emblem { display:grid; place-items:center; width:44px; height:44px; border-radius:16px; background:var(--morph-accent-soft); color:var(--morph-accent); font-size:26px; font-weight:600; }
.demo-close { position:absolute; top:18px; right:18px; display:grid; place-items:center; width:38px; height:38px; border-radius:50%; background:var(--morph-raised); color:var(--morph-text); font-size:23px; line-height:1; z-index:2; }
.demo-note { font-size:12px; color:var(--morph-muted); }
.demo-detail { display:flex; justify-content:space-between; padding:12px 0; border-bottom:1px solid var(--morph-border); font-size:14px; }
.demo-success { display:flex; flex-direction:column; gap:24px; }
.demo-success h3 { margin:0; font-size:24px; }
.demo-card { width:240px; padding:0; overflow:hidden; border-radius:24px; background:var(--morph-bg); color:var(--morph-text); text-align:left; box-shadow:0 8px 28px rgb(0 0 0 / .06); }
.demo-art { display:block; width:100%; height:200px; background:radial-gradient(circle at 66% 74%,var(--morph-accent) 0 26%,transparent 26.4%),radial-gradient(circle at 66% 74%,transparent 0 36%,color-mix(in srgb,var(--morph-accent) 34%,transparent) 36.4% 37.6%,transparent 38%),radial-gradient(circle at 26% 26%,var(--morph-muted) 0 7%,transparent 7.4%),var(--morph-raised); }
.demo-card-caption { display:flex; align-items:center; justify-content:space-between; padding:17px 19px; font-size:13px; }
.demo-card-caption span { font-size:18px; }
.demo-art-wide { height:46dvh; }
.demo-story { max-width:680px; margin:0 auto; padding:40px 28px 80px; }
.demo-story h2 { font-size:clamp(32px,5vw,52px); line-height:1.1; letter-spacing:-.03em; margin:18px 0 24px; }
.demo-story p:not(.demo-note) { color:var(--morph-muted); font-size:17px; line-height:1.7; margin:0 0 24px; }
.demo-feature { min-height:100%; }
@media(max-width:480px) { .demo-sheet { padding:66px 24px 28px; } .demo-dialog-panel { height:min(640px,100%); } }

/* Anchored surfaces: the trigger sits in the page, the surface comes out of it. */
.demo-stack { display:flex; flex-direction:column; align-items:center; gap:18px; width:100%; }
.demo-row { display:flex; flex-wrap:wrap; align-items:center; justify-content:center; gap:12px; }
/* An opaque trigger, because a surface borrows the trigger's fill for its first
   beat: opening out of a transparent ghost would start it invisible. */
.demo-popover-trigger { background:var(--morph-bg); }
.morph-popover__row input[type='checkbox'] { width:18px; height:18px; accent-color:var(--morph-accent); cursor:pointer; }
.demo-small { height:30px; padding:0 13px; border:0; border-radius:8px; background:var(--morph-accent); color:var(--morph-on-accent); font:inherit; font-size:12px; cursor:pointer; }
.demo-context { width:min(320px,100%); }
.demo-file { display:flex; align-items:center; gap:12px; width:100%; min-height:72px; padding:10px 14px; border:1px solid var(--morph-border); border-radius:var(--morph-radius-sm); background:var(--morph-bg); color:var(--morph-text); cursor:context-menu; user-select:none; -webkit-user-select:none; touch-action:manipulation; }
.demo-file:focus-visible { outline:2px solid var(--morph-accent); outline-offset:2px; }
.demo-file > span:nth-child(2) { display:grid; gap:2px; flex:1; }
.demo-file strong { font-size:14px; font-weight:500; }
.demo-file small { color:var(--morph-muted); font-size:11px; }
.demo-file-icon { display:grid; place-items:center; width:38px; height:38px; border-radius:10px; background:var(--morph-accent-soft); color:var(--morph-on-accent-soft); font-size:22px; }
.demo-file-favourite { color:var(--morph-muted); font-size:21px; }
.demo-notice { min-height:18px; margin:0; color:var(--morph-muted); font-size:11px; text-align:center; }

/* A control and its visible text side by side: the switch and the checkbox each
   decide their own text, so only the pair's layout lives here. */
.demo-label { font-size:15px; font-weight:500; color:var(--morph-text); cursor:pointer; -webkit-user-select:none; user-select:none; }
.demo-label[data-disabled] { color:var(--morph-muted); cursor:not-allowed; }
/* Two fields stacked at a readable measure: a text field at the width of the
   stage is a field nobody can scan. */
.demo-fields { display:grid; gap:16px; width:min(100%,340px); }
.demo-copy { margin:0; max-width:52ch; color:var(--morph-muted); font-size:14px; }

Usage

<MorphMultiSelect
  options={['Animation', 'Accessibility', 'Design systems', 'React']}
  value={value}
  onChange={setValue}
  label="Topics"
  aria-label="Search topics"
/>

options is every choice the field offers, and value is the ones that are chosen. onChange receives the whole selection after every change, so the field is controlled in the same way a combobox is.

The field itself opens the list, and the button at its right opens and closes it. A press that lands on a chip belongs to that chip, so removing a value is never mistaken for opening the list.

The order of the chips

Chips are rendered in the order options declares, not the order they were picked. Rendering the selection array meant a chip placed itself wherever it was clicked, so every add or remove reshuffled the field and every chip after the change moved whether or not anything about it had changed. Read from the source list instead, and a chip only ever moves because a neighbour left.

How a chip arrives

A chip does not fly in from its row. It fades in where it belongs while its neighbours slide to make room.

A copy of the row lifted off the list, crossing the panel to dissolve where the chip was waiting, was built and rejected: the trip is longer than the panel it crosses, so what the eye reads is a second label loose on the page rather than a choice being made — and a copy of a row is not a chip, so it never quite matched the thing it became. The field owns this change.

The movement itself is GSAP Flip, never in absolute mode. Absolutely positioning a chip to animate it takes it out of the flow for a frame, which flashes the whole field; in flow the chips are translated and never stop being laid out.

The chips are buttons

Each chip is a MorphButton on the chip variant, so the ripple, the press scale and the focus ring come from the same place every other button in the library gets them. Removing a chip is a press, and it is announced as one: the button’s accessible name is Remove <value>, not the value alone.

Keys

Typing filters the list, the arrow keys move and Enter toggles the active row. Backspace in an empty search removes the last chip, which is what the key is reaching for in every field of this kind.

Sizing

The panel is measured once as it lays itself out, which is why the search row and the footer stay put while the list scrolls under them. Pass height if you want a fixed panel instead.

API reference

MorphMultiSelect props

PropType / defaultDescription
optionsstring[]RequiredEvery choice the field offers, in the order they should be listed.
valuestring[]RequiredThe chosen values. The field renders them in options order, not the order they were picked.
onChange(next: string[]) => voidRequiredCalled with the whole selection after every change.
labelstring—The field’s visible label.
placeholderstring'Search…'Shown while nothing is chosen and as the search hint.
aria-labelstring—An accessible name for the search field.
widthnumbermeasuredThe resting width of the panel. Left out, it is measured as it lays itself out.
heightnumbermeasuredThe resting height of the panel. Pass both when the content can change size.
onOpenChange(open: boolean) => void—Notification when the surface is asked to open, and when it has closed.

Adding a chip is the field’s own change: it fades in where it belongs and its neighbours slide, rather than a copy of a row crossing the panel to become it. Backspace in an empty search removes the last chip.