Documentation menu
MorphInput
A field that says what it thinks, without moving what you are reading.
Example
The same component used in the preview. Works in JSX and TSX.
import { useState } from 'react';
import { MorphInput, type MorphInputStatus } from '@lestradavaz/morph-ui';
import './demo.css';
export default function InputDemo() {
const [email, setEmail] = useState('');
const [touched, setTouched] = useState(false);
const valid = /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
const status: MorphInputStatus = !touched || !email ? 'idle' : valid ? 'success' : 'error';
return (
<div className="demo-fields">
<MorphInput
label="Email address"
type="email"
autoComplete="email"
placeholder="name@example.com"
value={email}
status={status}
onChange={(event) => { setEmail(event.target.value); setTouched(true); }}
onBlur={() => setTouched(true)}
message={status === 'error' ? 'Enter a valid email address.' : status === 'success' ? 'Address looks good.' : undefined}
/>
<MorphInput label="Workspace" defaultValue="Morph" message="This one cannot be changed." 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
<MorphInput
label="Email address"
type="email"
value={email}
onChange={event => setEmail(event.target.value)}
status={valid ? 'success' : 'error'}
message={valid ? 'Address looks good.' : 'Enter a valid email address.'}
/>
label is required and always visible. A placeholder is not a label: it
disappears the moment there is something to read, which is the moment the reader
is least sure what the field wanted.
Every other prop goes to the underlying input, so type, name,
autoComplete, defaultValue and the aria attributes all work as you would
write them by hand.
The status is yours
status is 'idle', 'error' or 'success', and the component never decides
it. Whether an address is good enough is a policy, and the policy belongs to the
application — a component that validated your email field would be wrong about
somebody’s address eventually, and would be wrong silently.
Error and success change the border, the check mark and the colour of the
message line. aria-invalid is set for an error, and the message is wired to
the field with aria-describedby.
Nothing moves
The check mark is drawn inside the field’s own right-hand padding, which is reserved whether or not a mark is showing, and the message line is always in the layout at its full height. So a hint appearing mid-keystroke does not push the text the reader is looking at sideways or the page underneath them downwards.
The message is polite: aria-live="polite" announces it when it changes, and
never announces an empty line that is only holding the space.
Disabled
disabled goes to the input, which is where the browser expects it: the field
stops taking input, stops being submitted, and reports itself as unavailable.
API reference
MorphInput props
| Prop | Type / default | Description |
|---|---|---|
label | stringRequired | The field’s visible label. Always rendered: a placeholder is not a label. |
status | 'idle' | 'error' | 'success''idle' | What the field reports back. The component never decides this. |
message | string— | The line under the field. Its height is held whether or not there is a message. |
…rest | InputHTMLAttributes— | Every other prop goes to the underlying input, including type, name, value and aria-*. |
The check mark is drawn inside the field’s own right-hand padding, which is reserved whether or not a mark is showing, and the message line is always in the layout: a hint appearing mid-keystroke moves neither the text nor the page.