TextareaField Multi-line Input - DingTalk Help Center

When to Use

Use for scenarios that require entering large amounts of text, where the input area needs to be larger than a standard text input.

Component Example

Component Properties

Attribute	Description	Type	Default
`addonAfter`	Content appended after the input.	`string`	-
`addonBefore`	Content prepended before the multi-line input.	`string`	-
`autoFocus`	Whether to enable auto-focus.	`boolean`	`false`
`autoHeight`	Whether to enable auto height for the multi-line input.	`boolean`	`false`
`behavior`	Display state of the form component.	Behavior	`'NORMAL'`
`cutString`	Whether to truncate the string when it exceeds maxLength.	`boolean`	`false`
`hasClear`	Whether to enable the clear button on the multi-line text.	`boolean`	`true`
`hasLimitHint`	Whether to display the character counter for the multi-line text.	`boolean`	`false`
`label`	Title of the form component.	`string`	-
`labelAlign`	Position of the form component title.	`'left' \| 'top'`	`'top'`
`labelColOffset`	Offset position of the title. The value is a grid value, where 1 represents 1/24.	`number`	`0`
`labelColSpan`	Width of the title. The value is a grid value, where 1 represents 1/24.	`number`	`4`
`labelTextAlign`	Alignment of the form component title.	`'left' \| 'right'`	`'right'`
`labelTipsIcon`	Entry icon for the tips of the form component title. Takes effect when labelTipsTypes is set to text or render.	`string`	-
`labelTipsRender`	Custom render method for the tips of the form component title. Takes effect when labelTipsTypes is set to render.	`(props: IComponentProps) => ReactNode`	-
`labelTipsText`	Tips text for the form component title. Takes effect when labelTipsTypes is set to text.	`string`	-
`labelTipsTypes`	Type setting for the tips of the form component title.	LabelTipsTypes	`'none'`
`maxLength`	Character limit for the multi-line text.	`number`	-
`onChange`	Event triggered when the component value changes.	`({ value: string }) => void`	-
`placeholder`	Placeholder text for the form component.	`string`	`Please enter`
`rows`	Height of the multi-line text. Takes effect on PC only.	`number`	`4`
`size`	Size of the form component.	Size	`'medium'`
`state`	State of the input.	`'error' \| 'loading' \| 'success' \| ''`	`''`
`tips`	Description of the form component, displayed below the control.	`string`	-
`trim`	Whether to automatically trim leading and trailing whitespace.	`boolean`	`false`
`validation`	Validation settings for the form component. For details, see the form validation documentation.	Validation[]	`[]`
`value`	Default value of the current component.	`string`	-
`wrapperColOffset`	Offset position of the form component. The value is a grid value, where 1 represents 1/24.	`number`	`0`
`wrapperColSpan`	Width of the form component. The value is a grid value, where 1 represents 1/24.	`number`	`0`