Documentation menu
morphui Documentation

MorphSwitch

One position or the other, and the thumb travels between them.

Live preview
Flip one. The thumb travels, it does not jump.

Example

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

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

export default function SwitchDemo() {
  const [notifications, setNotifications] = useState(true);
  const [quiet, setQuiet] = useState(false);

  return (
    <div className="demo-stack">
      <div className="demo-row">
        <MorphSwitch id="demo-notifications" checked={notifications} onChange={setNotifications} label="Notifications" />
        <label className="demo-label" htmlFor="demo-notifications">Notifications</label>
      </div>
      <div className="demo-row">
        <MorphSwitch id="demo-quiet" checked={quiet} onChange={setQuiet} label="Quiet hours" />
        <label className="demo-label" htmlFor="demo-quiet">Quiet hours</label>
      </div>
      <div className="demo-row">
        <MorphSwitch id="demo-locked" checked={false} disabled label="Locked by your workspace" />
        <label className="demo-label" data-disabled htmlFor="demo-locked">Locked by your workspace</label>
      </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; }

Usage

<MorphSwitch label="Notifications" checked={on} onChange={setOn} />

label is the accessible name, and it is required. A switch is announced as a switch and then as nothing else, so a nameless one is a control the person using it cannot ask for. The visible text beside it is yours: give the switch an id, as in the example below, and point a <label htmlFor> at it.

<MorphSwitch id="notifications" label="Notifications" checked={on} onChange={setOn} />
<label htmlFor="notifications">Notifications</label>

Why it is CSS and not GSAP

A switch is pressed tens of times a day, and a press is not a morph. Both the track’s color and the thumb’s travel are transitions, which is what lets the second tap of a double tap retarget from wherever the thumb already is — a keyframe would start again from zero and the switch would visibly stutter.

It also means the switch works on a page that never imports a transition, and keeps working while the main thread is busy opening whatever the switch turned on.

A button, not a checkbox

role="switch" on a real <button>, with aria-checked reporting the state. The markup stays reachable and pressable the way every other control on the page is, and the label association above keeps the text clickable.

Press

The thumb stretches under the press instead of jumping to its new place: the travel is what the eye is following, and a squash keeps that legible while the finger is still down. Hover is gated behind a fine pointer, because touch fires a false hover on the way to the tap, which here would read as the switch reacting before it is pressed.

Reduced motion

The thumb does not travel. Everything that carries meaning — the track changing color, the focus ring, the press — stays.

API reference

MorphSwitch props

PropType / defaultDescription
labelstringRequiredThe accessible name. Hidden, and required: a switch is announced as a switch and then as nothing else.
checkedbooleanfalseWhether the switch is on. Control it, or let the component keep its own state and read it from onChange.
onChange(checked: boolean) => void—Called with the position the reader moved it to.
disabledbooleanfalseBlocks the press and reports itself.
…restButtonHTMLAttributes—Every other prop goes to the underlying button, including id, name and aria-*.

The visible text beside a switch is yours: give it an id and point a <label htmlFor> at it, which is what makes the text itself press the switch.