form 表单
收藏
我的收藏

基础库 1.0.0 开始支持本组件。​
表单,将组件内的用户输入的 switchinputcheckboxsliderradiopickertextarea 提交。​
当点击 form 表单中 formTypesubmitbutton 组件时,会将表单组件中的 value 值进行提交,需要在表单组件中加上 name 来作为 key。​

属性说明​

属性名​
类型​
默认值​
必填​
说明​
最低支持版本​
conversion-target​
number​
0​
否​
用于分发目的。取值:0 或 1,其中 0 表示默认,1 表示留资目标,需要和线索组件一起使用,详情见线索组件配置
2.88.0​
clue-component-id​
string​
""​
否​
用于分发目的。开发者在【小程序开发者后台 -> 进入目标小程序 -> 能力 -> 用户数据能力 -> 身份数据 -> 线索组件】申请能力后复制创建的配置 ID,需要和线索组件一起使用,详情见线索组件配置
2.88.0​
bindsubmit​
EventHandle​
无​
否​
携带 form 中的数据触发 submit 事件,event.detail = {value : {'name': 'value'} , ...}。​
1.0.0​
bindreset​
EventHandle​
无​
否​
表单重置时会触发 reset 事件。​
1.0.0​

扫码体验​

代码示例​

Bug & Tip​

Tip:如果 form 组件被嵌套使用,在进行提交操作时,将会收集距离该按钮最近的祖先 form 组件中所覆盖的表单数据,并对其 value 进行提交。