FormsInteractive playground
Textarea
Free-form text with a counter and adaptive height.
Preparing the playground…
Text and Markdown example
Textarea · Example
1<Textarea aria-label="Project description" placeholder="Tell us about your idea…" autoResize minRows={3} maxRows={6} maxLength={200} showCount />How to use it
Combine minRows and maxRows with autoResize to fit the content. maxLength sets the field limit.
Import
React / Next.js
1import { Textarea } from "@kivora/nextjs";Interactive examples run inside a component with "use client". The playground's Copy button includes the imports needed for the current example.
API reference 0.2.0
Types from the installed published version, including component properties and common HTML attributes. “Optional” does not imply a default value; omitting a property lets the component decide.
| Property | Type | Description |
|---|---|---|
aria-label | string | Accessible name of the control. |
autoComplete | string | Tell the browser which autocomplete type to use. |
autoResize | boolean | Adapt field height to its content. |
autoResizeDirection | "down" | "up" | Configures autoResizeDirection. The type describes the supported values and structure. |
children | ReactNode | Content or child elements of the component. |
className | string | Additional CSS classes to customize the element. |
defaultChecked | boolean | Initial selection of the control. |
defaultValue | string | number | readonly string[] | Initial value when the component manages its own state. |
disabled | boolean | Disable interaction with the control. |
id | string | Element identifier; associates labels and descriptions. |
invalid | boolean | Enable the visual error state. |
maxLength | number | Maximum number of characters. |
maxRows | number | Maximum height in rows. |
minRows | number | Minimum height in rows. |
name | string | Name used to identify the control in forms. |
onChange | ChangeEventHandler<HTMLTextAreaElement, HTMLTextAreaElement> | Change event. Check the type: some controls return an object, others a DOM event. |
onClick | MouseEventHandler<HTMLTextAreaElement> | Action performed when the element is activated. |
onSubmit | SubmitEventHandler<HTMLTextAreaElement> | Form submission event. |
placeholder | string | Short hint displayed when there is no value. |
required | boolean | Indicates that a value is required. |
role | AriaRole | Semantic role of the element. Keep the default role unless a change is justified. |
rows | number | Number of visible rows in the field. |
showCount | boolean | Show the character counter. |
size | "default" | "sm" | "lg" | null | Visual size of the component. |
style | CSSProperties | React inline styles. |
tabIndex | number | Keyboard focus order and availability. |
title | string | Title or supplementary information. |
value | string | number | readonly string[] | Controlled value. Update it from the change callback. |
TypeScript definition
Review each component's properties and published declaration. Native and accessibility attributes are inherited from the element specified by its type.
Textarea28 properties
Textarea · TypeScript
1Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>API generated from @kivora/nextjs 0.2.0View package