Data Display
Forms
Navigation
Input
A native input element.
import { Input } from "@/components/ui/input";
export default function Particle() {
return <Input aria-label="Enter text" placeholder="Enter text" type="text" />;
}
Installation
pnpm dlx cnippet@latest add input
Usage
import { Input } from "@/components/ui/input"<Input />Examples
For accessible labelling and validation, prefer using the Field component to wrap inputs, or the FieldControl component. See some related examples.
Sizes
Small
Default
Large
import { Input } from "@/components/ui/input";
export default function Particle() {
return (
<div className="space-y-4">
<div className="flex items-center justify-between gap-10 [&_p]:text-xs">
<p>Small</p>
<Input
aria-label="Enter text"
placeholder="Enter text"
size="sm"
type="text"
/>
</div>
<div className="flex items-center justify-between gap-10 [&_p]:text-xs">
<p>Default</p>
<Input aria-label="Enter text" placeholder="Enter text" type="text" />
</div>
<div className="flex items-center justify-between gap-10 [&_p]:text-xs">
<p>Large</p>
<Input
aria-label="Enter text"
placeholder="Enter text"
size="lg"
type="text"
/>
</div>
</div>
);
}
File
import { Input } from "@/components/ui/input";
export default function Particle() {
return <Input aria-label="File" type="file" />;
}
With Label
import { useId } from "react";
import { Input } from "@/components/ui/input";
import { Label } from "@/components/ui/label";
export default function Particle() {
const id = useId();
return (
<div className="flex flex-col items-start gap-2">
<Label htmlFor={id}>Email</Label>
<Input
aria-label="Email"
id={id}
placeholder="you@example.com"
type="email"
/>
</div>
);
}
With Button
import { Button } from "@/components/ui/button";
import { Input } from "@/components/ui/input";
export default function Particle() {
return (
<div className="flex gap-2">
<Input aria-label="Email" placeholder="you@example.com" type="email" />
<Button variant="outline">Send</Button>
</div>
);
}
Form Integration
"use client";
import * as React from "react";
import { Button } from "@/components/ui/button";
import { Field, FieldError, FieldLabel } from "@/components/ui/field";
import { Form } from "@/components/ui/form";
import { Input } from "@/components/ui/input";
export default function Particle() {
const [loading, setLoading] = React.useState(false);
const onSubmit = async (e: React.FormEvent<HTMLFormElement>) => {
e.preventDefault();
const formData = new FormData(e.currentTarget);
setLoading(true);
await new Promise((r) => setTimeout(r, 800));
setLoading(false);
alert(`Email: ${formData.get("email") || ""}`);
};
return (
<Form className="max-w-64" onSubmit={onSubmit}>
<Field>
<FieldLabel>Email</FieldLabel>
<Input
disabled={loading}
name="email"
placeholder="you@example.com"
required
type="email"
/>
<FieldError>Please enter a valid email.</FieldError>
</Field>
<Button disabled={loading} type="submit">
Submit
</Button>
</Form>
);
}