Textarea

Нативный элемент textarea.

Установка


pnpm dlx shadcn@latest add @oracul/textarea

Использование

import { Textarea } from "@/components/ui/textarea"

<Textarea />

В отличие от встроенных элементов управления формой Base UI, Base UI не предоставляет нативный примитив Textarea. Этот компонент внутренне оборачивает нативный элемент <textarea> в Field.Control, поэтому он интегрируется с Field «из коробки» — оборачивать его в FieldControl вручную не нужно.

<Field>
  <FieldLabel>Bio</FieldLabel>
  <Textarea placeholder="Расскажите о себе…" />
  <FieldDescription>Напишите краткую биографию.</FieldDescription>
  <FieldError>Это поле обязательно для заполнения.</FieldError>
</Field>

Справочник API

Textarea

Стилизованный нативный элемент textarea с настраиваемыми вариантами размера.

Свойство	Тип	По умолчанию	Описание
`size`	`"sm" \| "default" \| "lg" \| number`	`"default"`	Управляет внутренними отступами textarea. Числовые значения передаются в нативный атрибут `rows`
`unstyled`	`boolean`	`false`	Если true, убирает все стили по умолчанию

Примеры

Маленький размер

Большой размер

Отключённый

С меткой

Сообщение

import { useId } from "react";
import { Label } from "@/components/ui/label";
import { Textarea } from "@/components/ui/textarea";

export default function Particle() {
  const id = useId();
  return (
    <div className="flex flex-col items-start gap-2">
      <Label htmlFor={id}>Сообщение</Label>
      <Textarea id={id} placeholder="Введите сообщение" />
    </div>
  );
}

Интеграция с формой

"use client";

import type { FormEvent } from "react";
import { useState } from "react";
import { Button } from "@/components/ui/button";
import { Field, FieldError, FieldLabel } from "@/components/ui/field";
import { Form } from "@/components/ui/form";
import { Textarea } from "@/components/ui/textarea";

export default function Particle() {
  const [loading, setLoading] = useState(false);
  const onSubmit = async (e: FormEvent<HTMLFormElement>) => {
    e.preventDefault();
    const formData = new FormData(e.currentTarget);
    setLoading(true);
    await new Promise((r) => setTimeout(r, 800));
    setLoading(false);
    alert(`Сообщение: ${formData.get("message") || ""}`);
  };

  return (
    <Form className="flex w-full max-w-64 flex-col gap-4" onSubmit={onSubmit}>
      <Field>
        <FieldLabel>Сообщение</FieldLabel>
        <Textarea name="message" placeholder="Введите сообщение" required />
        <FieldError>Это поле обязательно для заполнения.</FieldError>
      </Field>
      <Button loading={loading} type="submit">
        Отправить
      </Button>
    </Form>
  );
}

На этой странице

Установка Использование Интеграция с Field Справочник API Textarea Примеры Маленький размер Большой размер Отключённый С меткой Интеграция с формой