Version: next

Form

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

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

参考文档

类型

ComponentType<FormProps>

示例代码

class App extends Component {
formSubmit = e => {
console.log(e)
}
formReset = e => {
console.log(e)
}
render () {
return (
<Form onSubmit={this.formSubmit} onReset={this.formReset} >
<View className='example-body'>
<Switch name='switch' className='form-switch'></Switch>
</View>
</Form>
)
}
}

FormProps

参数类型默认值必填说明
reportSubmit
boolean
false
是否返回
formId
用于发送模板消息。
reportSubmitTimeout
number
0
等待一段时间(毫秒数)以确认
formId
是否生效。
如果未指定这个参数,
formId
有很小的概率是无效的(如遇到网络失败的情况)。
指定这个参数将可以检测
formId
是否有效,
以这个参数的时间作为这项检测的超时时间。
如果失败,将返回
requestFormId:fail
开头的
formId
onSubmit
BaseEventOrigFunction<onSubmitEventDetail>
携带 form 中的数据触发 submit 事件
event.detail = { value : { name': 'value'}, formId: '' }
onReset
BaseEventOrigFunction<any>
表单重置时会触发 reset 事件

API 支持度

API微信小程序H5React Native
FormProps.reportSubmit✔️✔️
FormProps.reportSubmitTimeout✔️
FormProps.onSubmit✔️
FormProps.onReset✔️✔️✔️

onSubmitEventDetail

参数类型必填说明
value
{ [formItemName: string]: any; }
当点击
<form>
表单中
form-type
submit
<button>
组件时,
会将表单组件中的
value
值进行提交,
需要在表单组件中加上
name
来作为
key
formId
string
reportSubmit
true
时,返回
formId
用于发送模板消息。

API 支持度

API微信小程序H5React Native
Form✔️✔️✔️