TextArea
TextAreas are multiline text inputs, useful for cases where users have a sizable amount of text to enter. They allow for all customizations that are available to text fields.
size
labelPosition
contextualHelp
isDisabled
Value
Use the value
or defaultValue
prop to set the text value, and onChange
to handle user input.
Your comment:
import {TextArea} from '@react-spectrum/s2';
import {useState} from 'react';
function Example() {
let [name, setName] = useState('');
return (
<>
<TextArea
label="Comment"
value={name}
onChange={setName} />
<p>Your comment: {name}</p>
</>
);
}
Forms
Use the name
prop to submit the text value to the server. Set the isRequired
, minLength
, or maxLength
props to validate the value, or implement custom client or server-side validation. See the Forms guide to learn more.
isRequired
necessityIndicator
API
Name | Type | Default |
---|---|---|
size | 'S'
| 'M'
| 'L'
| 'XL' | Default: 'M'
|
The size of the text field. | ||
enterKeyHint | 'enter'
| 'done'
| 'go'
| 'next'
| 'previous'
| 'search'
| 'send' | Default: — |
An enumerated attribute that defines what action label or icon to preset for the enter key on virtual keyboards. See MDN. | ||
isDisabled | boolean | Default: — |
Whether the input is disabled. | ||
isReadOnly | boolean | Default: — |
Whether the input can be selected but not changed by the user. | ||
inputMode | 'none'
| 'text'
| 'tel'
| 'url'
| 'email'
| 'numeric'
| 'decimal'
| 'search' | Default: — |
Hints at the type of data that might be entered by the user while editing the element or its contents. See MDN. | ||
autoCorrect | string | Default: — |
An attribute that takes as its value a space-separated string that describes what, if any, type of autocomplete functionality the input should provide. See MDN. | ||
spellCheck | string | Default: — |
An enumerated attribute that defines whether the element may be checked for spelling errors. See MDN. | ||
styles | StylesProp | Default: — |
Spectrum-defined styles, returned by the style() macro. | ||
value | string | Default: — |
The current value (controlled). | ||
defaultValue | string | Default: — |
The default value (uncontrolled). | ||
onChange |
| Default: — |
Handler that is called when the value changes. | ||