Documentation menu
morphui Documentation

MorphPopover

The control unfolds into what it controls, and the page behind it stays put.

Live preview
Open it. The heading travels out of the button.

Example

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

MorphPopover example
import { useState } from 'react';
import { MorphButton, MorphClose, MorphPopover } from '@lestradavaz/morph-ui';
import './demo.css';

export default function PopoverDemo() {
  const [updates, setUpdates] = useState(true);
  const [sounds, setSounds] = useState(false);
  return (
    <MorphPopover
      label="Notification settings"
      width={292}
      /* The trigger keeps its label for the whole transition and the heading
         arrives as a copy of it: a control that emptied itself while the panel
         opened beside it would read as broken rather than as one word travelling. */
      shareWords
      trigger={
        <MorphButton variant="ghost" className="demo-popover-trigger">
          <span data-morph-words>Notification settings</span>
          <span aria-hidden="true">↗</span>
        </MorphButton>
      }
    >
      <h3 data-morph-words>Notification settings</h3>
      <p>Choose how this workspace keeps you informed.</p>
      <label className="morph-popover__row">
        <span><strong>Project updates</strong><small>Changes and comments</small></span>
        <input type="checkbox" checked={updates} onChange={event => setUpdates(event.target.checked)} />
      </label>
      <label className="morph-popover__row">
        <span><strong>Sounds</strong><small>Play a subtle alert</small></span>
        <input type="checkbox" checked={sounds} onChange={event => setSounds(event.target.checked)} />
      </label>
      <div className="morph-popover__footer">
        <MorphClose><button className="demo-small" type="button">Done</button></MorphClose>
      </div>
    </MorphPopover>
  );
}
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 surface grows out of the trigger’s own box, borrows its fill and its shadow for the first beat, and carries its contents on a transform rather than reflowing them. Nothing is tinted and nothing is made inert: a popover is the dialog’s motion without the dialog’s modality, which is what makes it the right shape for a control that belongs to the page rather than to a task.

<MorphPopover label="Notification settings" trigger={<button>Notification settings</button>}>
  <h3>Notification settings</h3>
  <p>Choose how this workspace keeps you informed.</p>
</MorphPopover>

The trigger is your element. MorphUI attaches a ref, a click and the aria wiring — aria-haspopup, aria-expanded and aria-controls — and changes nothing else about how you wrote it.

Sharing the label

Pass shareWords, mark the trigger’s text and the panel’s heading with data-morph-words, and the label travels out of the trigger into the heading and back again.

<MorphPopover
  label="Notification settings"
  shareWords
  trigger={<button><span data-morph-words>Notification settings</span></button>}
>
  <h3 data-morph-words>Notification settings</h3>
</MorphPopover>

The trigger keeps showing its own words for the whole trip. A dialog can blank its trigger because the panel lands on top of it; a popover opens beside the control it came from, and a button whose label emptied itself while a panel opened next to it would read as a broken button rather than as a word being carried.

Closing and focus

An outside press, Escape, or anything wrapped in MorphClose dismisses the surface, and closing returns focus to the trigger. Focus is not trapped while it is open: a surface that covers a corner of the page has no business holding the keyboard.

<div className="popover-footer">
  <MorphClose><button>Done</button></MorphClose>
</div>

Sizing

Leave width and height out and the surface is measured once as it lays itself out, so a short popover opens a short panel. Pass them when the content can change size while the surface is up — a surface that is being scaled cannot also be reflowed, so its size is fixed for as long as it is open.

Styling the contents

The body carries .morph-popover__body, and .morph-popover__row and .morph-popover__footer are there for the usual shape of a settings panel: a labelled row with its control on the right, and a footer along the bottom edge. They are ordinary classes; use them or ignore them.

API reference

MorphPopover props

PropType / defaultDescription
triggerReactElementRequiredYour own element. MorphUI attaches a ref, an onClick and the aria wiring.
childrenReactNodeRequiredContent rendered inside the surface.
labelstringRequiredAn accessible name for the panel.
widthnumbermeasuredThe resting width of the surface. Left out, it is measured as it lays itself out.
heightnumbermeasuredThe resting height of the surface. Pass both when the content can change size.
shareWordsbooleanfalseFly the trigger’s words into a heading marked data-morph-words.
panelClassNamestring—Classes on the surface. Use this to set its appearance.
defaultOpenbooleanfalseOpens on mount. For a popover that is part of a guided first run.
onOpenChange(open: boolean) => void—Notification when the surface is asked to open, and when it has closed.

Dismissal is an outside press, Escape, or anything wrapped in MorphClose. Focus is not trapped: a surface that does not cover the page has no business holding the keyboard.