多行输入
适用场景
用于输入多行的文字内容
基础能力说明
绑定「文本」类型字段
表单容器绑定数据模型后，在表单容器的字段属性中，可将文本字段映射生成的组件切换为多行输入，实现多行数据的提交
输入值属性说明
输入值属性表示组件的默认表单值，可绑定变量或表达式实现输入值的动态变更
常见场景实践说明
属性介绍
组件接收的外部传入的属性
属性名 | 属性标识 | 类型 | 说明 |
|---|
| 绑定字段 | name | string | 提交表单时会将组件值提交保存到所配置的字段中 示例："formTextarea" |
| 字段标题 | label | string | 组件标题位置的显示内容 示例："标题" |
| 显示标题 | labelVisible | boolean | 显示组件的标题 示例：true |
| 提示文字 | placeholder | string | 用于说明组件用途或注意事项的提示文字 示例："请输入" |
| 输入值 | value | string | 组件输入框中的默认值 示例："" |
| 必填 | required | boolean | 启用后该组件强制必填，值不可为空 示例：false |
| 必填标识 | requiredFlag | boolean | 启用后，组件若要求必填，则会显示必填星号标记 示例：true |
| 必填校验提示 | requiredMsg | string | 启用必填，但组件值为空时的提示信息 示例："该项为必填项" |
| 布局方式 | layout | string | 设置当前组件的标题和输入选择区域为左右布局或上下布局，如选择“自动”，则跟随父级表单容器的配置 示例："" |
| 组件宽度(PC端) | size | string | 示例："full" |
| 显示字数 | counterVisible | boolean | 组件右下角展示已输入字数/最大字数限制 示例：true |
| 最大输入长度 | maxLength | number | 允许输入的最大字符数量 示例：140 |
| 获取焦点 | focus | boolean | 启用后，打开页面时，该组件的输入框将自动获取焦点（多组件启用时，仅最下方的组件生效） 示例：false |
| 禁用 | disabled | boolean | 是否禁用输入/选择，启用后组件强制显示为只读效果 示例：false |
事件介绍
组件暴露的事件，可以监听组件的事件来触发一些外部的动作
事件名 | 事件code | 事件出参 event.detail | 适用情况 | 说明 |
|---|
| 值改变 | change | 兼容三端 | - | |
| 失去焦点 | blur | 兼容三端 | - | |
| 获取焦点 | focus | 兼容三端 | - | |
| 清空内容 | clear | 兼容三端 | - | |
| 确认内容 | confirm | 兼容三端 | - |