Documentation menu
morphui Documentation

MorphButton

A press that starts where your finger landed, and a shape for every job.

Live preview
Press anywhere on a button. The ripple starts there.

Example

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

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

export default function ButtonDemo() {
  const [loading, setLoading] = useState(false);
  return (
    <div className="demo-stack">
      <div className="demo-row">
        <MorphButton>Publish</MorphButton>
        <MorphButton variant="ghost">Preview</MorphButton>
        <MorphButton variant="chip">Draft</MorphButton>
        <MorphButton variant="icon" aria-label="Add to favourites">★</MorphButton>
      </div>
      <div className="demo-row">
        <MorphButton size="sm">Small pill</MorphButton>
        <MorphButton variant="ghost" size="sm">Small ghost</MorphButton>
        <MorphButton disabled>Disabled</MorphButton>
      </div>
      <div className="demo-row">
        <MorphButton loading={loading} onClick={() => setLoading(!loading)}>
          {loading ? 'Saving…' : 'Press to load'}
        </MorphButton>
      </div>
    </div>
  );
}
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; }

Variants

pill is the primary action, ghost the quiet one beside it, chip a tag or a filter, and icon a square for a single glyph. All four share the same press, the same hover step and the same focus ring, so a row of mixed variants still reads as one family.

<MorphButton>Publish</MorphButton>
<MorphButton variant="ghost">Preview</MorphButton>
<MorphButton variant="chip">Draft</MorphButton>
<MorphButton variant="icon" aria-label="Add to favourites">★</MorphButton>

Sizes are md and sm. sm lowers the height and the type one step and keeps the shape, so a small pill is still a pill.

Loading and disabled

loading swaps the label for a spinner in place, which is what keeps the button’s width from changing at the moment it is pressed. The label blurs out and the spinner blurs in over the same duration the hover uses, so the change belongs to the same motion as everything else on the button.

<MorphButton loading={saving} onClick={save}>{saving ? 'Saving…' : 'Save'}</MorphButton>

disabled is the native attribute and behaves as one: no hover, no press, and no ripple.

Pressing

The ripple starts where the pointer landed rather than in the centre, because a press that comes from the middle of a wide button animates from somewhere the finger never was. Under prefers-reduced-motion the button keeps its colour changes, loses the scale and the ripple, and the spinner stops turning without disappearing.

Using it as a trigger

A MorphButton is an ordinary button, so it is a perfectly good trigger for a dialog, a window or a popover: pass it as trigger and MorphUI attaches the ref and the click it needs.

<MorphPopover label="Filters" trigger={<MorphButton variant="ghost">Filters</MorphButton>}>
  …
</MorphPopover>

One thing worth knowing: a surface borrows the fill of the control it opens from. A ghost button is transparent, so give it a background if you want the surface to open out of something visible. The demo on this page does exactly that.

API reference

MorphButton props

PropType / defaultDescription
variant'pill' | 'ghost' | 'chip' | 'icon''pill'The primary action, the quiet one, a tag, or a square.
size'sm' | 'md''md'The small size keeps the shape and lowers the height.
loadingbooleanfalseShows a spinner in place of the label and blocks the press without changing the button’s size.
childrenReactNode—The label. An icon-only button needs an aria-label instead.
disabledbooleanfalseInherited from the native button.
…restButtonHTMLAttributes—Every other prop goes to the underlying button, including type, name, onClick and aria-*.

The ripple, the press and the loading state are CSS, so they work on a page that never imports a transition, and they keep working while the main thread is busy opening the panel the button just asked for.