Documentation menu
morphui Documentation

MorphTooltip

A quiet hint, for the pointer and for the keyboard.

Live preview
Rest on a button, or tab to one.

Example

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

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

export default function TooltipDemo() {
  return (
    <div className="demo-row">
      <MorphTooltip tip="The same curve, at every scale">
        <MorphButton variant="ghost" size="sm">Inspect motion</MorphButton>
      </MorphTooltip>
      <MorphTooltip side="bottom" tip="Focus reveals this hint too">
        <MorphButton variant="ghost" size="sm">Keyboard focus</MorphButton>
      </MorphTooltip>
    </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; }

Usage

Wrap the control you want to describe. The hint appears when the pointer rests on it and when it takes keyboard focus, and leaves the moment either goes away.

<MorphTooltip tip="The same curve, at every scale">
  <MorphButton variant="ghost">Inspect motion</MorphButton>
</MorphTooltip>

Why it does not morph

A tooltip is read tens of times a day and answered in a glance. The dialog’s clock over a bubble this small would be an eternity, and the bubble is a caption for the control rather than something the control becomes — there is no box to grow out of and nothing to carry. It fades and lifts on the library’s own slide duration and its own softening curve, which is what keeps it in the same family without pretending to be the same motion.

Anything opened a hundred times a day should not animate at all; anything opened a few times a day should be nearly imperceptible. A tooltip is the second case, and the whole transition is 200ms.

Side and delay

side puts the bubble above the control by default, or below it with side="bottom" for a control near the top of the page. delay is how long the pointer must rest before the hint appears — 180ms by default, and it does not apply to focus, which is immediate because a keyboard user has already made the decision.

<MorphTooltip side="bottom" delay={300} tip="Focus reveals this hint too">
  <button>Keyboard focus</button>
</MorphTooltip>

Accessibility

The hint is attached with aria-describedby while it is open, so a screen reader announces the control first and the hint after it, and never announces a hidden one. The bubble itself is role="tooltip".

A hint is a description, not a name: never move a control’s only label into a tooltip. If the control has no visible text, it needs an aria-label of its own.

API reference

MorphTooltip props

PropType / defaultDescription
childrenReactElementRequiredThe control the hint describes. Its own handlers are kept and added to.
tipReactNodeRequiredThe hint itself. A word, or a short sentence.
side'top' | 'bottom''top'Which side of the control the bubble sits on.
delaynumber180How long the pointer must rest before the hint appears, in milliseconds. Focus is immediate.

The hint is attached with aria-describedby while it is open, so a screen reader announces the control first and the hint after it, and never announces a hidden one.