跳到主要内容

多行输入

适用场景

用于输入多行的文字内容

基础能力说明

绑定「文本」类型字段

表单容器绑定数据模型后,在表单容器的字段属性中,可将文本字段映射生成的组件切换为多行输入,实现多行数据的提交

输入值属性说明

输入值属性表示组件的默认表单值,可绑定变量或表达式实现输入值的动态变更

常见场景实践说明

  1. 实现通过变量获取和改变表单值 查阅文档
  2. 清空表单内容 查阅文档
  3. 表单组件隐藏时,提交对应表单数据 查阅文档

属性介绍

组件接收的外部传入的属性

属性名
属性标识
类型
说明
绑定字段namestring

提交表单时会将组件值提交保存到所配置的字段中

示例:"formTextarea"

字段标题labelstring

组件标题位置的显示内容

示例:"标题"

显示标题labelVisibleboolean

显示组件的标题

示例:true

提示文字placeholderstring

用于说明组件用途或注意事项的提示文字

示例:"请输入"

输入值valuestring

组件输入框中的默认值

示例:""

必填requiredboolean

启用后该组件强制必填,值不可为空

示例:false

必填标识requiredFlagboolean

启用后,组件若要求必填,则会显示必填星号标记

示例:true

必填校验提示requiredMsgstring

启用必填,但组件值为空时的提示信息

示例:"该项为必填项"

布局方式layoutstring

设置当前组件的标题和输入选择区域为左右布局或上下布局,如选择“自动”,则跟随父级表单容器的配置

示例:""

组件宽度(PC端)sizestring

示例:"full"

显示字数counterVisibleboolean

组件右下角展示已输入字数/最大字数限制

示例:true

最大输入长度maxLengthnumber

允许输入的最大字符数量

示例:140

获取焦点focusboolean

启用后,打开页面时,该组件的输入框将自动获取焦点(多组件启用时,仅最下方的组件生效)

示例:false

禁用disabledboolean

是否禁用输入/选择,启用后组件强制显示为只读效果

示例:false

事件介绍

组件暴露的事件,可以监听组件的事件来触发一些外部的动作

事件名
事件code
事件出参 event.detail
适用情况
说明
值改变change兼容三端

-

失去焦点blur兼容三端

-

获取焦点focus兼容三端

-

清空内容clear兼容三端

-

确认内容confirm兼容三端

-