form

基础库 1.0.0 开始支持本组件。

表单，将组件内的用户输入的 switch、input、checkbox、slider、radio、picker 、textarea提交。

当点击 form 表单中 formType 为 submit 的 button 组件时，会将表单组件中的 value 值进行提交，需要在表单组件中加上 name 来作为 key。

属性说明

属性名	类型	默认值	必填	说明	最低支持版本
bindsubmit	Function		否	携带 form 中的数据触发 submit 事件，event.detail = {value : {'name': 'value'} , formId: '', ...}	1.0.0
bindreset	Function		否	表单重置时会触发 reset 事件	1.0.0
report-submit	boolean	false	否	是否返回 formId 用于发送模板消息	1.29.0
report-submit-timeout	number	0	否	等待一段时间（毫秒数）以确认 formId 是否生效。如果未指定这个参数，formId 有很小的概率是无效的（如遇到网络失败的情况）。指定这个参数将可以检测 formId 是否有效，以这个参数的时间作为这项检测的超时时间。如果失败，将返回 requestFormId:fail 开头的 formId	1.29.0

代码示例

开发者工具中预览

扫码体验

请使用字节宿主APP扫码

Bug & Tip

• Tip：嵌套的 form 会采集外层与内层的数据。