Textarea 文本域
输入多行文本,如留言、简介或备注。
基础用法
使用多行输入框编辑文本,并为字段提供关联名称。
basic.tsx
示例
状态
使用 readOnly、disabled 或 FormField 的错误信息表达字段状态。
states.tsx
自动高度
autoSize 根据内容调整高度,minRows 与 maxRows 限制行数;达到最大高度后在文本域内滚动。
auto-size.tsx
字数统计
设置 showCount 显示统计,搭配 maxLength 限制输入长度。
count.tsx
受控输入
通过 value 和 onChange 管理内容,示例用当前值更新长度提示。
controlled.tsx
表单接入
使用 FormField 或 aria-label 提供名称。设置 name 可参与原生表单提交;非受控值支持表单重置,受控值需同步重置应用状态。表单接入见 Form。
API
Textarea API
配置多行文本、字数限制和输入状态。
TextareaAutoSize API
限制自动调整高度时使用的最小和最大行数。