Documentation menu
morphui Documentation

MorphCombobox

The field opens into the list it is choosing from.

Live preview
Open the list. The mark travels with the choice.

Example

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

MorphCombobox example
import { useState } from 'react';
import { MorphCombobox, type MorphComboboxOption } from '@lestradavaz/morph-ui';
import './demo.css';

const workspaces: MorphComboboxOption[] = [
  { value: 'studio', label: 'Design studio', detail: '12 projects', group: 'Recent' },
  { value: 'product', label: 'Product team', detail: '8 projects', group: 'Recent' },
  { value: 'sandbox', label: 'Sandbox', detail: '24 experiments', group: 'All workspaces' },
  { value: 'archive', label: 'Component archive', detail: '41 components', group: 'All workspaces' },
];

export default function ComboboxDemo() {
  const [value, setValue] = useState('studio');
  return (
    <MorphCombobox
      options={workspaces}
      value={value}
      onChange={setValue}
      label="Workspace"
      aria-label="Search workspaces"
      placeholder="Search workspaces…"
    />
  );
}
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

The list is the dialog’s morph at one trigger’s scale: it grows out of the field, wears the field’s fill and corners for the first beat, and carries its rows on a transform rather than reflowing them, so they travel with the box instead of appearing inside it.

<MorphCombobox
  options={[
    { value: 'studio', label: 'Design studio', detail: '12 projects', group: 'Recent' },
    { value: 'sandbox', label: 'Sandbox', detail: '24 experiments', group: 'All workspaces' },
  ]}
  value={value}
  onChange={setValue}
  label="Workspace"
  aria-label="Search workspaces"
/>

It is a controlled field: it reports the choice and never picks one for you.

Options and groups

Each option needs a value and a label. detail is a second line under the label and is searched along with it. group files options under a shared heading, rendered in the order the groups first appear — so the same list can be sorted by recency without the markup saying anything about it.

The travelling mark

The first letter of the current choice is drawn in the field and again on the row it belongs to, both marked data-morph-item="mark". On open, a copy of it flies from the field to the row; on close it flies home. The field keeps showing its own letter for the whole trip, because the field is still on screen next to the list.

Typing, keys and the arrow

Typing filters the list. The arrow keys move the active row and Enter chooses it. Opening with the arrow keys, or by clicking the field, clears the query and starts again from the top.

Escape closes the list and leaves the field focused. The arrow at the right of the field is a button, not decoration: it opens and closes the list for anyone using a pointer.

Sizing

Left out, the size is measured from the options the list was opened with, so three options open a short panel. Pass width and height when the list is long enough to need its own scroll, or when it changes size while it is open: a surface that is being scaled cannot also be reflowed, so its size is fixed for as long as it is up.

API reference

MorphCombobox props

PropType / defaultDescription
optionsMorphComboboxOption[]Requiredvalue, label, and optionally detail and group.
valuestringRequiredThe chosen value. The combobox is controlled: it never picks for you.
onChange(value: string) => voidRequiredCalled when a row is chosen.
labelstring—The field’s visible label.
placeholderstring'Search…'Shown while the field is empty.
aria-labelstring—An accessible name for the field. Set this when there is no visible label.
widthnumbermeasuredThe resting width of the list. Left out, it is measured as it lays itself out.
heightnumbermeasuredThe resting height of the list. 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.

Typing filters. Arrow keys move and Enter chooses, Escape closes and leaves the field focused, and the arrow at the end of the field opens and closes the list for anyone using a pointer.