Textarea 多行输入
uni-appH5微信小程序App
跨端多行文本输入框,支持自适应高度和字数统计。
何时使用
多行长文本录入:备注、简介、反馈内容。
何时不使用
单行短文本用 Input;富文本编辑需引入编辑器组件。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "" | 绑定值,配合 v-model 使用 |
label | string | "" | 输入框上方标签文本 |
placeholder | string | "" | 占位文本 |
disabled | boolean | false | 禁用(灰底) |
maxlength | number | -1 | 最大输入长度,传入后右下角显示 已输/上限 计数 |
autoHeight | boolean | false | 高度随内容自适应(等价 autosize) |
showCount | boolean | false | 右下角显示字数统计 |
rows | number | 3 | 行数;autosize 时作为最小行数 |
readonly | boolean | false | 只读 |
autosize | boolean | false | 随内容自动增高,基于 scrollHeight 实现 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 输入时同步绑定值 |
input | string | - |
change | string | 失焦时值发生变化才触发 |
focus | Event | 聚焦时触发 |
blur | Event | 失焦时触发 |
示例
基础用法
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" />