文本域组件,多行文本输入的文本框,当输入的文本内容超过组件宽度时会自动换行显示。
用户登录AppGallery Connect, 点击全部服务 > 开发构建 > Serverless > DevEco低代码,选择应用进入项目页面,选择元服务应用,点击编辑应用进入元服务开发页面,在组件>官方组件中可看到文本域组件。点击中心编辑区右上角页面锁,解锁获取编辑权限,将文本域组件拖入到编辑区,即完成使用。选中编辑区富文本,在右侧的页签对其属性和事件进行设置。

字段标题 | 类型 | 是否必选 | 默认值 | 描述 |
|---|---|---|---|---|
提示文本 | string | 否 | 无 | 文本内容为空时,默认显示的文本内容。 |
文本内容 | string | 否 | 无 | 文本域组件默认显示的内容。 |
提示文本颜色 | number | string | Color | 否 | #8c8c8c | 设置提示文本颜色 |
提示文本字体大小(不支持API6) | number | 否 | 16vp | 设置提示文本字体大小 |
提示文本字体粗细(不支持API6) | FontWeight | number | string | 否 | 粗细正常 | 设置提示文本字体粗细,包含正常、更细、常规、中等、加粗、更粗、100、200、300、400、500、600、700、800、900选项。number类型取值[100, 900],取值间隔为100,默认为400,取值越大,字体越粗。string类型仅支持number类型取值的字符串形式,例如"400",以及"bold"、"bolder"、"lighter"、"regular"、"medium"。 |
提示文本字体列表(不支持API6) | string | 否 | sans-serif | 设置提示文本字体。 |
提示文本字体样式(不支持API6) | 否 | 标准 | 设置提示文本字体样式,包含默认、标准、斜体选项。 | |
输入框光标颜色 | number | string | Color | 否 | #000000 | 设置输入框光标颜色。 |
特有属性设置后展示效果如下图。

在右侧文本内容中输入内容后,提示文本消失,删除文本内容后,提示文本出现。

在编辑区选中组件后,可以在右侧的事件页签中对其进行定义。

事件类型 | 是否必选 | 描述 |
|---|---|---|
变更 | 否 | 输入内容发生变化时,触发该事件。 |
复制 | 否 | 长按输入框内部区域弹出剪贴板后,点击剪切板复制按钮,触发该事件。 |
剪切 | 否 | 长按输入框内部区域弹出剪贴板后,点击剪切板剪切按钮,触发该事件。 |
粘贴 | 否 | 长按输入框内部区域弹出剪贴板后,点击剪切板粘贴按钮,触发该事件。 |
导入真机的效果图:
