Ballmac UI home

Textarea

A multi-line text field that can grow with its content between minRows and maxRows, then scroll. Plain resizable mode when autoResize is off.

We read every message. Please don't include passwords.

Installation

$ pnpm dlx shadcn@latest add @ballmac/textarea

Usage

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

The full example is in the Code tab above.

Examples

Auto-resize

API reference

PropTypeDefault
autoResize

Grow and shrink with the content instead of scrolling.

booleanfalse
minRows

Smallest height in rows when autoResize is on. Defaults to `rows` or 3.

number—
maxRows

Largest height in rows when autoResize is on; past it the textarea scrolls.

number—

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
TabMoves focus to the textarea
EnterInserts a new line

Quality scorecard

7/7

Every applicable check passes

Measured in Chromium 153.0.8010.12 on October 19, 2026, on version 1.0.0, across 2 examples.

How we measure
  • Passed: Accessibility scan

    No serious or critical issues in light and dark, on a phone and a desktop (axe-core 4.13.0, WCAG 2.1 AA and best-practice rules).

  • Passed: Small screens

    No sideways scrolling at 360, 390 or 1280 px wide.

  • Passed: Reduced motion

    No endless animation to begin with.

  • Passed: Right to left

    Mirrors correctly in Arabic, Hebrew, Persian and Urdu layouts (0% of elements off the mirror, limit 15%).

  • Passed: Clean console

    No console errors or React hydration errors while loading.

  • Passed: Keyboard

    2 tab stops, each showing a visible change when it takes focus. 2 documented keys.

  • Not applicable: Loading, empty and error

    Does not show data or take submissions.

  • Passed: Automated tests

    Covered by textarea.test.tsx.

  • For information: Footprint

    1.4 KB of source (gzip) in 1 file. No extra npm packages.

Automated checks find a subset of problems and do not replace testing with a screen reader and a keyboard in your own app. What they miss.

Use with AI

Multi-line text input. Set autoResize with minRows and maxRows for chat composers and comment boxes; leave it off for a user-resizable box with a fixed rows count. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Textarea (@ballmac/textarea) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Comments, feedback and descriptions
  • Chat or prompt composers that grow as the user types (autoResize)
  • Notes fields in settings forms

Not for

  • Single-line values (use input)
  • Rich text or markdown editing with formatting controls

Registry JSON: https://ui.ballmac.com/r/textarea.json

Credits

Based on shadcn/ui Textarea, adapted by Ballmac. Free to use in personal and commercial projects.

npm
None
Registry
shadcn/utils

Ballmac UI Pro

Need the whole screen, not one piece?

311 premium blocks (dashboards, settings, calendars, mail, shops, onboarding), a private shadcn registry and Figma tokens. Blocks that show data come with loading, empty and error states built in.

Not ready? Try three Pro blocks free

Leave your email and the blocks appear right here, ready to copy. Yours to use in any project.