名称
类型
默认值
必填
描述
placeholder
string
-
否
多行文本框的提示文本内容。
maxlength
number
多行文本框可输入的最多字符数量。
headericon
在文本输入前的图标展示，该图标不支持点击事件，图标格式为jpg，png和svg。
extend
boolean
false
文本框是否支持可扩展，设置可扩展属性后文本框高度可以跟随文字自适应。
value5+
多行文本框的内容。
showcounter5+
文本框是否需要开启计数下标功能，需要配合maxlength一起使用。
menuoptions5+
Array<MenuOption>
设置文本选择弹框点击更多按钮之后显示的菜单项。
autofocus6+
是否自动获焦。
selectedstart6+
-1
开始选择文本时初始选择位置。
selectedend6+
开始选择文本时结尾选择位置。
softkeyboardenabled6+
true
编辑时是否弹出系统软键盘。
icon
菜单选项中的图标路径。
content
菜单选项中的文本内容。
color
<color>
#e6000000
多行文本框的文本颜色。
font-size
<length>
16px
多行文本框的文本尺寸。
allow-scale
多行文本框的文本尺寸是否跟随系统设置字体缩放尺寸进行放大缩小。
如果在config描述文件中针对ability配置了fontSize的config-changes标签，则应用不会重启而直接生效。
placeholder-color
#99000000
多行文本框的提示文本颜色，type为text|email|date|time|number|password时生效。
font-weight
number | string
normal
多行文本框的字体粗细，见text组件font-weight的样式属性。
font-family
sans-serif
多行文本框的字体列表，用逗号分隔，每个字体用字体名或者字体族名设置。列表中第一个系统中存在的或者通过自定义字体指定的字体，会被选中作为文本的字体。
caret-color6+
设置输入光标的颜色。
参数
change
{ text: newText, lines: textLines, height: textHeight }
输入内容发生变化时触发该事件，通过参数获取输入内容、行数和行高。
改变value属性值不会触发该回调。5+
translate5+
{ value: selectedText }
设置此事件后，进行文本选择操作后文本选择弹窗会出现翻译按钮，点击翻译按钮之后，触发该回调，返回选中的文本内容。
share5+
设置此事件后，进行文本选择操作后文本选择弹窗会出现分享按钮，点击分享按钮之后，触发该回调，返回选中的文本内容。
search5+
设置此事件后，进行文本选择操作后文本选择弹窗会出现搜索按钮，点击搜索按钮之后，触发该回调，返回选中的文本内容。
optionselect5+
{ index:optionIndex, value: selectedText }
文本选择弹窗中设置menuoptions属性后，用户在文本选择操作后，点击菜单项后触发该回调，返回点击的菜单项序号和选中的文本内容。
selectchange6+
{ start: number，end: number }
文本选择变化时触发事件。