For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/zh/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/zh/llms-full.txt, and this page is available as Markdown at https://rickyshin93.github.io/tao-ui/zh/components/textarea.md.
v0.0.57
  • 简体中文
  • Textarea

    数据录入@rockshin/tao-ui

    输入多行文本,并支持状态、尺寸、变体与自动高度。

    何时使用

    用户需要输入说明、备注或其他多行内容时使用 Textarea。

    推荐

    • 通过 FormField 提供标签与错误信息。
    • 合理限制自动高度范围。

    避免

    • 短单行内容应使用 Input。

    代码演示

    基础用法

    TSX

    变体

    TSX

    尺寸与自动高度

    TSX

    受控输入与字数

    原生 maxLength 限制输入,受控值用于显示剩余字数。

    0 / 120
    TSX

    有界自动高度

    输入多行内容,观察高度在 minRows 与 maxRows 之间增长。

    TSX

    只读、禁用与错误

    分别表达可阅读、不可操作和需要修正的状态。

    TSX

    表单提交与重置

    通过 name 读取文本域内容,reset 恢复默认值。

    TSX

    定制输入外观

    通过语义部件设置文本域样式,保留组件状态与焦点行为。

    TSX

    清空与计数

    Textarea 与 Input.TextArea 是同一组件,支持 allowClear、onClear、showCount、count、onPressEnter 和 variant="underlined"。查看完整输入家族示例与 API。

    API

    Textarea

    属性说明类型默认值
    autoSizeAuto-grow height to fit content. true grows freely; pass min/max rows to clamp.boolean | AutoSizeOptions | undefined-