Documentation menu
Example
The same component used in the preview. Works in JSX and TSX.
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-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
| Prop | Type / default | Description |
|---|---|---|
options | MorphComboboxOption[]Required | value, label, and optionally detail and group. |
value | stringRequired | The chosen value. The combobox is controlled: it never picks for you. |
onChange | (value: string) => voidRequired | Called when a row is chosen. |
label | string— | The field’s visible label. |
placeholder | string'Search…' | Shown while the field is empty. |
aria-label | string— | An accessible name for the field. Set this when there is no visible label. |
width | numbermeasured | The resting width of the list. Left out, it is measured as it lays itself out. |
height | numbermeasured | The 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.