FORMS / COMPONENT 27

Text area

React component

Write longer content in a resizable multiline field.

Try it out

Use the live controls or open the Code tab to view and copy the example.

47/240 characters

API reference

Generated from the package’s TypeScript exports. Standard React event and ARIA attributes are also accepted where the component wraps a native element.

PropTypeDescription
onValueChange((value: string) => void) | undefinedCalled with the next value. Update controlled state here.
autoCompletestring | undefinedStandard React / HTML attribute passed to the underlying element.
disabledboolean | undefinedDisables interaction (or date matchers for DatePicker).
maxLengthnumber | undefinedStandard React / HTML attribute passed to the underlying element.
minLengthnumber | undefinedStandard React / HTML attribute passed to the underlying element.
namestring | undefinedField name used in form submission.
placeholderstring | undefinedStandard React / HTML attribute passed to the underlying element.
readOnlyboolean | undefinedStandard React / HTML attribute passed to the underlying element.
requiredboolean | undefinedParticipates in native form validation.
rowsnumber | undefinedRecords to render. The library does not fetch data.
valuestring | number | readonly string[] | undefinedControlled value. Pair with its change callback.
onChangeChangeEventHandler<HTMLTextAreaElement, HTMLTextAreaElement> | undefinedStandard React / HTML attribute passed to the underlying element.
defaultCheckedboolean | undefinedStandard React / HTML attribute passed to the underlying element.
defaultValuestring | number | readonly string[] | undefinedInitial value for uncontrolled usage.
classNamestring | undefinedAdditional CSS class names.
idstring | undefinedStandard React / HTML attribute passed to the underlying element.
styleCSSProperties | undefinedInline styles, including CSS custom property overrides.
relstring | undefinedStandard React / HTML attribute passed to the underlying element.
childrenReactNodeContent rendered inside the component.
onFocusFocusEventHandler<HTMLTextAreaElement> | undefinedStandard React / HTML attribute passed to the underlying element.
onBlurFocusEventHandler<HTMLTextAreaElement> | undefinedStandard React / HTML attribute passed to the underlying element.
onErrorReactEventHandler<HTMLTextAreaElement> | undefinedStandard React / HTML attribute passed to the underlying element.
onClickMouseEventHandler<HTMLTextAreaElement> | undefinedStandard React / HTML attribute passed to the underlying element.
labelRequiredstringA meaningful visible or accessible label.
descriptionstring | undefinedSupporting instructions associated with the control.
errorstring | undefinedValidation message; also sets aria-invalid.
hideLabelboolean | undefinedSee the typed definition and working example for this option.

Accessibility & interaction

Use a persistent visible label and provide textual errors; native controls support keyboard input and browser form constraints.

Visible focus, reduced motion, and both color themes are shared across staqui. Choose labels and document structure that make sense in your application; automated checks do not replace assistive-technology testing.

Variants & implementation notes

Native textarea with rows, min/maxLength and vertical resizing. Character counting is an application composition, shown in the example.

Use the typed API above for the supported variants. The example demonstrates the primary composition; shared controls inherit hover, focus, active and disabled treatment where applicable.

Compose with