Form

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

当点击 form 表单中 formTypesubmitbutton 组件时,会将表单组件中的 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>
  10. <view class="section">
  11. <view class="section__title">input</view>
  12. <input name="input" placeholder="please input here" />
  13. </view>
  14. <view class="section section_gap">
  15. <view class="section__title">radio</view>
  16. <radio-group name="radio-group">
  17. <label><radio value="radio1"/>radio1</label>
  18. <label><radio value="radio2"/>radio2</label>
  19. </radio-group>
  20. </view>
  21. <view class="section section_gap">
  22. <view class="section__title">checkbox</view>
  23. <checkbox-group name="checkbox">
  24. <label><checkbox value="checkbox1"/>checkbox1</label>
  25. <label><checkbox value="checkbox2"/>checkbox2</label>
  26. </checkbox-group>
  27. </view>
  28. <view class="btn-area">
  29. <button formType="submit">Submit</button>
  30. <button formType="reset">Reset</button>
  31. </view>
  32. </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