小程序开放平台

文档中心
表单组件
button
checkbox
checkbox-group
editor
form
input
label
picker
picker-view
picker-view-column
radio
radio-group
slider
switch
textarea
基础内容
媒体组件
地图
视图容器
导航组件
开放能力
画布

textarea

开发
>
组件
>
表单组件
>
textarea
>
更新时间:2025-12-09 14:38:25

textarea

多行输入框。该组件是原生组件,使用时请注意相关限制

属性
类型
默认值
必填
说明
valuestring输入框的初始内容
placeholderstring输入框为空时占位符
placeholder-stylestring指定 placeholder 的样式,目前仅支持color,font-size和font-weight
placeholder-classstringtextarea-placeholder指定 placeholder 的样式类
disabledbooleanfalse是否禁用
maxlengthnumber140最大输入长度,设置为 -1 的时候不限制最大长度
auto-focusbooleanfalse自动聚焦,拉起键盘
focusbooleanfalse获取焦点
auto-heightbooleanfalse是否自动增高,设置auto-height时,style.height不生效
cursornumber指定focus时的光标位置
selection-startnumber-1光标起始位置,自动聚集时有效,需与selection-end搭配使用
selection-endnumber-1光标结束位置,自动聚集时有效,需与selection-start搭配使用
bindinputeventhandle键盘输入时触发,event.detail = {value, cursor, keyCode},keyCode 为键值,处理函数可以直接 return 一个字符串,将替换输入框的内容
bindfocuseventhandle输入框聚焦时触发,event.detail = { value, height },height 为键盘高度
bindblureventhandle输入框失去焦点时触发,event.detail = { value, encryptedValue, encryptError }

组件示例

该文档是否对您有帮助?