Tac UIv1.1.2

Textarea

A multi-line text input for longer-form content, with optional label and error state. Built on top of React Native's TextInput with multiline enabled.

Import

tsx
import { Textarea } from '@tac-ui/native';

Playground

Interactively configure the Textarea props below.

tsx
<Textarea placeholder="Enter your message..." />

Sizes

Three size options control the padding, font size, and minimum height of the textarea.

tsx
<Textarea size="sm" placeholder="Small textarea" />
<Textarea size="md" placeholder="Medium textarea (default)" />
<Textarea size="lg" placeholder="Large textarea" />

Default

The base textarea renders a resizable multi-line field with the same border transitions as the Input component.

tsx
<Textarea placeholder="Enter your message..." />

With Label

Pass label to render a text label above the textarea. Use rows to control the initial visible height.

Description
tsx
<Textarea label="Description" placeholder="Describe your project..." rows={4} />

With Helper Text

helperText renders a muted hint below the textarea when there is no active error, providing contextual guidance to the user.

Bio
Maximum 500 characters.
tsx
<Textarea label="Bio" placeholder="Tell us about yourself..." helperText="Maximum 500 characters." />

Error State

Set error to apply destructive border styling. Pass errorMessage to show an error message below the field.

Bio
Bio must be at least 20 characters.
tsx
<Textarea label="Bio" placeholder="Tell us about yourself" error errorMessage="Bio must be at least 20 characters." />

Disabled

Set editable to false to disable the textarea. It renders at reduced opacity and ignores all user interaction.

tsx
<Textarea placeholder="Disabled textarea" editable={false} />

API Reference

PropTypeDefaultDescription
size"sm" | "md" | "lg""md"Controls the padding, font size, and minimum height.
labelstring-Label displayed above the textarea.
helperTextstring-Helper text displayed below the textarea when there is no error.
errorbooleanfalseApplies error styling when true.
errorMessagestring-Error message displayed when error is true.
rowsnumber4Minimum number of text rows (controls the minimum height).
editablebooleantrueWhen false, disables the textarea and reduces its opacity.
containerStyleViewStyle-Additional styles applied to the outer container View.
...TextInputProps--All standard React Native TextInput props are supported.