Skip to the content

Controls and surfaces

textarea

A multi-line text input that grows with its content, with an invalid state.

Controls

When to use it

Free text of more than one line: a message, a note, a description. Wrap it in field for a label and an error; use input for a single line.

See it working

The demonstration the browser checks drive, with the keyboard as well as the pointer. More of it is on the Controls page.

Button

Field, input, textarea

Used for sign-in only.

Select, slider, choices

Add it

npx shadcn@latest add @rivier-ui/textarea

The registry is named once in components.json: see Installation.

Example

Import it from @/components/ui/textarea.

<Textarea placeholder="Tell us about the project" rows={4} />
<Textarea aria-invalid="true" aria-label="Message" defaultValue="Too short" />

What it needs

Plain markup: it can stay a server component. No packages beyond React.

It imports

Source

The whole file. Once copied it is yours: the registry item holds the same text.

src/components/ui/textarea.tsx
/**
 * @name textarea
 * @category ui
 * @description A multi-line text input that grows with its content, with an invalid state.
 * @when Free text of more than one line: a message, a note, a description. Wrap it in field for a label and an error; use input for a single line.
 * @example
 * <Textarea placeholder="Tell us about the project" rows={4} />
 * <Textarea aria-invalid="true" aria-label="Message" defaultValue="Too short" />
 */
import type { ComponentProps } from "react";
import { cn } from "@/lib/cn";

export function Textarea({ className, ...props }: ComponentProps<"textarea">) {
  return (
    <textarea
      data-slot="textarea"
      className={cn(
        "field-sizing-content block min-h-20 w-full min-w-0 rounded-control border border-input bg-background px-3 py-2 text-sm text-foreground transition-[border-color,opacity] duration-instant ease-out placeholder:text-muted-foreground disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive motion-reduce:transition-none",
        className,
      )}
      {...props}
    />
  );
}