Documentation menu
morphui Documentation

MorphTabs

The panel changes at once, and the pill takes its own time.

Live preview

The panel changes at once. The pill takes its own time, because the pill is only the record of where you are.

Press a tab. The panel is already there; the pill is what travels.

Example

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

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

export default function TabsDemo() {
  return (
    <MorphTabs
      label="Component details"
      tabs={[
        {
          label: 'Overview',
          content: <p className="demo-copy">The panel changes at once. The pill takes its own time, because the pill is only the record of where you are.</p>,
        },
        {
          label: 'Motion',
          content: <p className="demo-copy">One curve for arriving, one for travelling. The same pair every component in the library is built on.</p>,
        },
        {
          label: 'Keys',
          content: <p className="demo-copy">Arrow keys move and select together, without the slide: a keyboard is held down, and a pill that lags behind is a pill that is somewhere else when you stop.</p>,
        },
      ]}
    />
  );
}
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

<MorphTabs
  label="Component details"
  tabs={[
    { label: 'Overview', content: <p>…</p> },
    { label: 'Motion', content: <p>…</p> },
  ]}
/>

tabs is the list, each one needing a label — which is also its key — and its content. defaultIndex picks where it starts, and label names the tab list for anyone who cannot see it; a page with two tab lists needs two names.

The panel is immediate, the pill is not

The reader asked for a tab, so the tab has to be there. The pill is only the record of where they are, and it slides on the library’s own on-screen curve after the content has already changed. A panel that faded in behind a moving pill would make every press feel slower than it is, and there is nothing to explain: no content is appearing, it is already on the page.

A keyboard skips the slide

Arrow keys move the selection and the focus together, and they move without the animation. A keyboard is held down: five presses in a row would leave a pill somewhere behind the reader, still travelling while they are reading.

Home and End go to the ends, and the default is prevented even when the arrow leads nowhere, so Home at the first tab does not scroll the page out from under the list.

The pill is measured

Its position and width come from the tab it belongs to, in pixels. A pill sized as a fraction of the bar breaks on the first two-word label, and it is the only thing on screen saying which tab is on. A mouse press animates it; a keyboard move places it; the first paint places it.

Accessibility

A real role="tablist" with role="tab" buttons, aria-selected, and each tab pointing at its panel with aria-controls. Only the selected tab is in the tab order — the arrow keys are how the rest are reached, which is what a tab list is expected to do — and the panel is labelled by its tab.

API reference

MorphTabs props

PropType / defaultDescription
tabsMorphTab[]Requiredlabel and content for each tab. The label is also its key.
defaultIndexnumber0Which tab starts selected. The component keeps the choice itself from there.
labelstring'Sections'An accessible name for the tab list. A page with two of them needs two names.
onSelect(index: number) => void—Called when the selection changes, by pointer or by keyboard.

The panel changes immediately and the pill takes 200ms: the reader asked for the tab, so the tab is there, and the pill is only the record of where they are. Arrow keys, Home and End move selection and focus together, without the slide.