Documentation menu
Example
The same component used in the preview. Works in JSX and TSX.
import { MorphWindow, MorphClose } from '@lestradavaz/morph-ui';
import './demo.css';
export default function WindowDemo() {
return (
<MorphWindow
aria-label="A little context"
panelClassName="demo-window-panel"
trigger={<button className="demo-chip" type="button">A little context</button>}
chrome={<MorphClose><button className="demo-close" type="button" aria-label="Close window">×</button></MorphClose>}
>
<div className="demo-sheet">
<h2>A little context</h2>
<p>Some things need a little more room, without losing your place.</p>
<p>The button you pressed is still there, untouched. This window grew out beside it, and it will go back the same way.</p>
<div className="demo-detail"><span>Opening</span><span>700 ms</span></div>
<div className="demo-detail"><span>Closing</span><span>500 ms</span></div>
<MorphClose><button className="demo-primary" type="button">Got it</button></MorphClose>
</div>
</MorphWindow>
);
}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
A window grows out beside the button that opened it. The button stays where it is, keeps the way it looks, and is still there when the window closes — which is the difference between this and a dialog, where the trigger becomes the panel and is gone for the duration.
That is what the preview above shows, and it is what you get with no props beyond the trigger.
Use panelClassName to size the window. Its position remains centered in the viewport while its animation begins at the trigger.
Sharing the label instead
Pass shareWords and mark a heading with data-morph-words, and the trigger’s label flies into it, in both directions. Sharing anything hands the trigger’s surface to the window and hides it for the duration, so the window then opens the way a dialog does and differs only in its blur and its closing curve. Pick it when the label matters more than the trigger staying put.
<MorphWindow
shareWords
aria-label="More information"
trigger={<button>More information</button>}
>
<h2 data-morph-words>More information</h2>
<MorphClose><button>Got it</button></MorphClose>
</MorphWindow>
Closing and focus
Use MorphClose, Escape, or the backdrop. The window returns the way it came while its contents soften and close. Always provide a visible close action and an accessible dialog name.
A close button pinned to a corner goes in chrome instead of the children, so it keeps its own size and its corner rather than stretching with the panel and drifting as it settles. See MorphDialog.
API reference
MorphWindow props
| Prop | Type / default | Description |
|---|---|---|
trigger | ReactElementRequired | A single element that forwards its ref to a DOM node. |
children | ReactNodeRequired | Content rendered inside the window. |
shareWords | booleanfalse | Connect trigger text to a heading marked data-morph-words. Sharing hands the trigger’s surface to the panel. |
dismissOnTintClick | booleantrue | Close when the surrounding backdrop is clicked. |
chrome | ReactNode— | Panel furniture such as the close button. Its own layer over the panel, held at its own size and corner for the whole transition. |
panelClassName | string— | Classes on the visible panel. Use this to set its size and appearance. |
className | string— | Classes on the outer native dialog. |
aria-label | string— | An accessible name for the window. Set this for every instance. |
onOpenChange | (open: boolean) => void— | Notification when opening starts and closing finishes. |
MorphClose, Escape and the backdrop all close a window. Whatever you pass as chrome rides above the panel rather than inside it.