【微信小程序】From表单（88/100）

原创已于 2025-08-24 20:29:00 修改 · 1.3k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#微信小程序 #小程序 #微信小程序switch #微信小程序怎么打断点调试 #微信小程序单选框 #微信开发者工具mac #微信小程序断点调试

于 2022-07-18 21:59:46 首次发布

微信小程序专栏收录该内容

29 篇文章

订阅专栏

本文介绍了微信小程序中UI组件如switch, radio, checkbox, slider, input的使用，并展示了表单提交的实现。在表单提交时，组件需设置name属性以供数据传递。此外，讨论了form组件的submit和reset事件，以及属性report-submit和bindsubmit的用途。文章还推荐了一款名为SmartApi的API调试工具，作为Postman的替代品，具备API参数填写、响应数据展示和Mock等功能，特别适合日常开发调试。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在这里插入图片描述
UI布局：

<!--pages/from/from.wxml-->
<form catchsubmit="formSubmit" catchreset="formReset">
  <view class="page-section-title">switch</view>
  <switch name="switch" />

  <view class="page-section-title">radio</view>
  <radio-group name="radio">
    <label>
      <radio value="radio1" />选项一
    </label>
    <label>
      <radio value="radio2" />选项二
    </label>
  </radio-group>

  <view class="page-section-title">checkbox</view>
  <checkbox-group name="checkbox">
    <label>
      <checkbox value="checkbox1" />选项一
    </label>
    <label>
      <checkbox value="checkbox2" />选项二
    </label>
  </checkbox-group>

  <view class="page-section-title">slider</view>
  <slider value="50" name="slider" show-value></slider>

  <view class="page-section-title">input</view>
  <view class="weui-cell__bd" style="margin: 30rpx 0">
    <input class="weui-input" name="input" placeholder="这是一个输入框" />
  </view>

  <button style="width: 100%; margin: 30rpx 0" type="primary" formType="submit">Submit</button>
  <button style="width: 100%; margin: 30rpx 0" formType="reset">Reset</button>

</form>

数据模型& 控制

// pages/from/from.js
Page({

  /**
   * 页面的初始数据
   */
  data: {
    pickerHidden: true,
    chosen: ''
  },
  pickerConfirm(e) {
    this.setData({
      pickerHidden: true
    })
    this.setData({
      chosen: e.detail.value
    })
  },
  pickerCancel() {
    this.setData({
      pickerHidden: true
    })
  },
  pickerShow() {
    this.setData({
      pickerHidden: false
    })
  },

  formSubmit(e) {
    console.log('form发生了submit事件，携带数据为：', e.detail.value)
  },

  formReset(e) {
    console.log('form发生了reset事件，携带数据为：', e.detail.value)
    this.setData({
      chosen: ''
    })
  },
  /**
   * 生命周期函数--监听页面加载
   */
  onLoad(options) {

  },

结果如下图：
在这里插入图片描述

功能描述

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

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

属性说明

属性类型默认值必填说明最低版本
report-submit boolean false 否是否返回 formId 用于发送模板消息 1.0.0

report-submit-timeout number 0 否等待一段时间（毫秒数）以确认 formId 是否生效。如果未指定这个参数，formId 有很小的概率是无效的（如遇到网络失败的情况）。指定这个参数将可以检测 formId 是否有效，以这个参数的时间作为这项检测的超时时间。如果失败，将返回 requestFormId:fail 开头的 formId 2.6.2

bindsubmit eventhandle 否携带 form 中的数据触发 submit 事件，event.detail = {value : {‘name’: ‘value’} , formId: ‘’} 1.0.0

bindreset eventhandle 否表单重置时会触发 reset 事件 1.0.0