• form

    form

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

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

    属性名类型说明最低版本
    report-submitBoolean是否返回 formId 用于发送模板消息 。formId有很小的概率是无效的（如遇到网络失败或因违规使用被封禁接口的情况），如果无效，将返回 requestFormId:fail 开头的 formId
    bindsubmitEventHandle携带 form 中的数据触发 submit 事件，event.detail = {value : {'name': 'value'} , formId: ''}
    bindresetEventHandle表单重置时会触发 reset 事件

    示例代码：

    1. <form bindsubmit="formSubmit" bindreset="formReset">
    2.   <view class="section section_gap">
    3.     <view class="section__title">switch</view>
    4.     <switch name="switch" />
    5.   </view>
    6.   <view class="section section_gap">
    7.     <view class="section__title">slider</view>
    8.     <slider name="slider" show-value></slider>
    9.   </view>
    11.   <view class="section">
    12.     <view class="section__title">input</view>
    13.     <input name="input" placeholder="please input here" />
    14.   </view>
    15.   <view class="section section_gap">
    16.     <view class="section__title">radio</view>
    17.     <radio-group name="radio-group">
    18.       <label>
    19.         <radio value="radio1" />
    20.         radio1
    21.       </label>
    22.       <label>
    23.         <radio value="radio2" />
    24.         radio2
    25.       </label>
    26.     </radio-group>
    27.   </view>
    28.   <view class="section section_gap">
    29.     <view class="section__title">checkbox</view>
    30.     <checkbox-group name="checkbox">
    31.       <label>
    32.         <checkbox value="checkbox1" />
    33.         checkbox1
    34.       </label>
    35.       <label>
    36.         <checkbox value="checkbox2" />
    37.         checkbox2
    38.       </label>
    39.     </checkbox-group>
    40.   </view>
    41.   <view class="btn-area">
    42.     <button form-type="submit">Submit</button>
    43.     <button form-type="reset">Reset</button>
    44.   </view>
    45. </form>
    1. Page({
    2.   formSubmit(e) {
    3.     console.log('form发生了submit事件，携带数据为：', e.detail.value)
    4.   },
    5.   formReset() {
    6.     console.log('form发生了reset事件')
    7.   }
    8. })

    form