Skip to content
On this page

textarea

多行输入框。

原生组件,使用时请注意相关限制。

Props

参数类型默认值必填说明
valuestring输入框的初始内容(支持 v-model:value)
placeholderstring输入框为空时占位符
placeholder-classstringtextarea-placeholder指定 placeholder 的样式类
placeholder-stylestring指定 placeholder 的样式
disabledbooleanfalse是否禁用输入框
maxlengthnumber140最大输入长度,设置为 <= 0 的时候不限制最大长度
focusbooleanfalse获取焦点
auto-heightbooleanfalse是否自适应高度,设置 auto-height 时,style.height 不生效
cursor-spacingnumber0指定光标与键盘的距离。取 textarea 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离
cursornumberfalse指定 focus 时的光标位置
selection-startnumber-1光标起始位置,自动聚集时有效,需与 selection-end 搭配使用
selection-endnumber-1光标结束位置,自动聚集时有效,需与 selection-start 搭配使用
show-confirm-barbooleantrue是否显示键盘上方带有”完成“按钮那一栏
adjust-positionbooleantrue键盘弹起时,如果输入框被键盘遮盖,是否自动上推页面
hold-keyboardbooleantruefocus时,点击页面的时候不收起键盘
disable-default-paddingbooleanfalse是否去掉 iOS 下的默认内边距
confirm-typestringreturn设置键盘右下角按钮的文字
合法值说明
send发送
search搜索
next下一个
go前往
done完成
return换行
confirm-holdbooleanfalse点击键盘右下角按钮时是否保持键盘不收起

Events

事件名说明回调参数
input输入的值发生变化时触发{ value: string }
focus输入框成为焦点时触发{ value: string }
blur输入框失去焦点时触发{ value: string }
confirm点击完成按钮时触发{ value: string }
keyboard-height-change键盘高度发生变化的时候触发{ height: number, duration: number }
linechange输入框行数变化时调用{ height: number, lineCount: number }

Example

vue
<template>
  <textarea v-model:value="text" placeholder="请输入账号" />
</template>

<script setup lang="ts">
import { ref } from 'vue'

const text = ref('Evoker')
</script>