Form

表单，用于将组件内的用户输入的 <textarea>、 <switch/>、 <input/> 、<checkbox-group/>、<slider/>、<radio-group/>、<picker/> 等组件提交。

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

img.jpg

属性名类型默认值描述最低版本
report-submitbooleanonSubmit 回调是否返回 formId 用于发送 模板消息，使用前可使用 canIUse('form.report-submit') 判断是否支持1.3.0
onSubmitEventHandle携带 form 中的数据触发 submit 事件，event.detail = {value : {'name': 'dao14'}, buttonTarget: {'dataset': 'buttonDataset'} }buttonTarget1.7.0 开始支持
onResetEventHandle表单重置时会触发 reset 事件

Screenshot

form

示例代码

  1. <form onSubmit="formSubmit" onReset="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><radio value="radio1"/>radio1</label>
  19.       <label><radio value="radio2"/>radio2</label>
  20.     </radio-group>
  21.   </view>
  22.   <view class="section section_gap">
  23.     <view class="section__title">checkbox</view>
  24.     <checkbox-group name="checkbox">
  25.       <label><checkbox value="checkbox1"/>checkbox1</label>
  26.       <label><checkbox value="checkbox2"/>checkbox2</label>
  27.     </checkbox-group>
  28.   </view>
  29.   <view class="btn-area">
  30.     <button formType="submit">Submit</button>
  31.     <button formType="reset">Reset</button>
  32.   </view>
  33. </form>
  1. Page({
  2.   formSubmit: function(e) {
  3.     console.log('form发生了submit事件，携带数据为：', e.detail.value)
  4.   },
  5.   formReset: function() {
  6.     console.log('form发生了reset事件')
  7.   }
  8. })

原文: https://docs.alipay.com/mini/component/form