Documentation menu
Example
The same component used in the preview. Works in JSX and TSX.
import { useState } from 'react';
import { MorphRadio } from '@lestradavaz/morph-ui';
import './demo.css';
const density = [
{ value: 'comfortable', label: 'Comfortable' },
{ value: 'cosy', label: 'Cosy' },
{ value: 'compact', label: 'Compact' },
];
export default function RadioDemo() {
const [value, setValue] = useState('cosy');
return (
<div className="demo-stack">
<MorphRadio name="demo-density" label="Density" options={density} value={value} onChange={setValue} />
<MorphRadio name="demo-density-locked" label="Density, fixed by the workspace" options={density} value="comfortable" disabled />
</div>
);
}Preview stylesheet 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
<MorphRadio
name="density"
label="Density"
options={[
{ value: 'comfortable', label: 'Comfortable' },
{ value: 'cosy', label: 'Cosy' },
{ value: 'compact', label: 'Compact' },
]}
value={value}
onChange={setValue}
/>
name is the group’s name, so the browser keeps its own arrow-key behaviour and
a form that contains the group still reads it. label is the group’s accessible
name; value is the chosen option.
The panel
The rows sit on a raised track and the chosen one is marked by a panel behind it. The panel is placed and sized in pixels from the row it belongs to, because the rows are whatever your text makes them — a group whose rows are told apart by a fixed height breaks on the first two-line option, and the panel is the only thing saying which row is chosen.
It moves on ease-in-out rather than ease-out. This is something travelling to
a new place, not something arriving, and the difference is visible at this size:
the panel leaves and lands at the same speed instead of sprinting out of the row
it came from.
The panel is set, not animated, on the first pass and whenever the reader prefers reduced motion. Nothing travels in from nowhere.
Real inputs
Every option is a real radio input, visually hidden, inside its own label. Arrow
keys move the selection and change it, which is the behaviour a radio group is
expected to have and which a row of buttons with aria-checked would have to
reimplement.
Disabled
A disabled group reports itself to assistive technology and takes no pointers. The panel stays where it is: a group with no choice still shows which one is carried, if any.
API reference
MorphRadio props
| Prop | Type / default | Description |
|---|---|---|
name | stringRequired | The group’s name, so the browser keeps its own arrow-key behaviour. |
label | stringRequired | The group’s accessible name. |
options | MorphRadioOption[]Required | value and label, for each row. |
value | string— | The chosen value. With nothing chosen, the panel stays hidden. |
onChange | (value: string) => void— | Called with the value the reader moved to. |
disabled | booleanfalse | Blocks the whole group without hiding which option is carried. |
The panel behind the chosen row is sized from that row, so rows of any height work. It is placed rather than animated on the first pass and under prefers-reduced-motion.