跳到主要内容

Textarea 多行输入 ​

uni-appH5微信小程序App

跨端多行文本输入框,支持自适应高度和字数统计。

何时使用 ​

多行长文本录入:备注、简介、反馈内容。

何时不使用 ​

单行短文本用 Input;富文本编辑需引入编辑器组件。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Textarea 多行输入 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
modelValuestring""绑定值,配合 v-model 使用
labelstring""输入框上方标签文本
placeholderstring""占位文本
disabledbooleanfalse禁用(灰底)
maxlengthnumber-1最大输入长度,传入后右下角显示 已输/上限 计数
autoHeightbooleanfalse高度随内容自适应(等价 autosize)
showCountbooleanfalse右下角显示字数统计
rowsnumber3行数;autosize 时作为最小行数
readonlybooleanfalse只读
autosizebooleanfalse随内容自动增高,基于 scrollHeight 实现

Events ​

名称载荷说明
update:modelValuestring输入时同步绑定值
inputstring-
changestring失焦时值发生变化才触发
focusEvent聚焦时触发
blurEvent失焦时触发

示例 ​

基础用法 ​

vue
<Textarea v-model="bio" placeholder="介绍一下自己" />

计数与自适应 ​

vue
<Textarea v-model="desc" placeholder="填写详细描述" :maxlength="100" show-count auto-height />

禁用 ​

vue
<Textarea v-model="bio" disabled placeholder="不可编辑" />

行数与自适应 ​

vue
<Textarea v-model="bio" :rows="4" placeholder="固定 4 行高度" />
<Textarea v-model="desc" autosize placeholder="高度随内容自适应" style="margin-top:10px" />