---
title: Textarea 多行文本框
description: 用于承载用户多行信息录入的组件，常用于描述信息、反馈表单中意见等需要一段相当长文本的场景。可以设置最大文案长度。
isComponent: true
usage: { title: "", description: "" }
spline: message
author: { code: "swimly", doc: "swimly" }
---

## 基本用法

通过`value`，`defaultValue`，`v-model`来设置他的值，**defaultValue 或者 value：** 通过该方式赋值为默认值，并不会印象操作
和绑值，**v-model：** 通过该方式赋值为响应式，通过`inputValue`可设置输入框的值，此属性谨慎使用，一旦设置后期不可更改，推
荐使用`defaultInputValue`替代。

{{ base }}

## 限制输入长度

类似原生输入框的 maxlength 属性，通过`maxcharacter`或者`maxlength`可设置输入框可输入的最长文本，二者选其一即可
，maxcharacter 一个中文字符代表 2 个字符，maxlength 一个中文代表一个字符，当设置的值小于 0 则不限制输入长度。

{{ limit }}

## 自动高度

高度自动撑开。 设置了 `autosize = true` 表示组件高度自动撑开，同时，依旧允许手动拖高度。如果设置了 `autosize.maxRows` 或
者 `autosize.minRows` 则不允许手动调整高度。

{{ autoHeight }}

## 不同状态

通过`status`可设置多行输入框的状态，可选：`success`，`warning`，`error`，还可通过`tips`来设置他的提示文本。

{{ status }}

## 禁用

通过`disabled`可设置多行文本框的禁用状态，通过`readonly`设置其只读状态。

{{ disabled }}
