微信小程序表单校验提交重置,及真机测试路径注意事项

微信小程序表单校验提交重置,数据互通(没接触过小程序,第一次写小程序,简单做个总结),代码中注释比较详细,可以多注意

微信小程序页面

index.js页面

import WxValidate from '../../utils/WxValidate.js'//小程序表单校验工具导入
Page({
  /**
  * 页面的初始数据
  */
  data: {
    // 普通选择器列表设置,及初始化
    countyList: ['', '', '', ''],//地区集合
    countyIndex: 0,
    default: '请选择(必填)',
    //表单数据绑定name属性
    from:{
      PHONE: '',
     NAME: '',
    }
  },
  // 选择地区
  changeCounty(e) {
    let countyIndex = e.detail.value
    let countyList = this.data.countyList
    this.setData({
      countyIndex,
      default: countyList[countyIndex]
    })
  },
  //确认按钮把数据上传后台
  formSubmit: function (e) {
    console.log('form发生了submit事件,携带数据为:', e.detail.value);
    var that = this;
    var formData = e.detail.value;
    var AREA = this.data.countyList[e.detail.value.AREA];//区县
    formData.AREA=AREA;//重新赋值
    if (!this.WxValidate.checkForm(formData)) {
      const error = this.WxValidate.errorList[0]
      this.showModal(error)
      return false
    }
    wx.request({
      url: 'URL',//不能使用localhost 要写明ip 不然真机无法测试
      data: {
        formData
      },
      method: 'POST',
      header: {
        'content-type': 'application/json' // 默认值
      },
      success: function (res) {
        console.log('返回数据:', res);
         //成功后清空数据并提示用户
        if (res.data.status == 1){
          //提交成功后清空数
          that.setData({
          //wxml页面将表单需要清空的input框绑定value='{{form_info}}'
            form_info: ''
          })
          //重置下拉框数据
          that.setData({
            default: '请选择(必填)'
          });
          wx.showToast({
            title: '成功',
            icon: 'success',
            duration: 2000//持续的时间
          })
         }else{
          wx.showToast({
            title: '失败',
            icon: 'error',
            duration: 2000//持续的时间
          })
         }
      },
    })
  },
  formReset:function(e){
    //重置自带表单重置,picker需要手动修改值
    this.setData({
      default:'请选择(必填)'
    })
  },
  //报错 
  showModal(error) {
    wx.showModal({
      content: error.msg,
    })
  },
  /***验证表单字段 */
  initValidate:function() {
    const rules = {
      PHONE: {
        required: true,
        tel: true
      },
      NAME: {
        required: true,
        maxlength: 10,
      }, 
    }
    const messages = {
      PHONE: {
        required: '请填写联系电话',
        tel: '请填写正确的联系电话'
      },
      NAME: {
        required: '请填写姓名',
        maxlength: '名称长度不超过10个字!'
      },
    }
    this.WxValidate = new WxValidate(rules, messages)
  },
  /**
  * 生命周期函数--监听页面加载
  */
  onLoad: function (options) {
    this.initValidate()//验证规则函数 必须放在该方法下面 否则会报错,找不到checkForm方法
  },
})

index.wxml页面

//index.wxml页面
<!--pages/biji/biji.wxml-->
<form bindsubmit="formSubmit" bindreset="formReset">

<view class='input_w professional'>
<text class='left'>投诉电话:</text>
<view class='input left'>
<input placeholder='请输入电话号码(必填)' cursor-spacing='20' name='PHONE' value='{{form_info}}'></input>
</view>
</view>

<view class='input_w professional'>
<text class='left'>客户名称:</text>
<view class='input left'>
<input placeholder='请输入客户名称(必填)' cursor-spacing='20' name='NAME' value='{{form_info}}'></input>
</view>
</view>

<view class='input_w professional'>
<text class='left'>地区选择:</text>
<view class='input left'>
<picker bindchange="changeCounty"  value="{{countyIndex}}" range="{{countyList}}" name="AREA">
    <view class="picker">
     {{default}}
    </view>
  </picker>
</view>
</view>
//多行文本框,存在与input框不对齐问题未解决,会的欢迎留言告知,如果觉得不会管只能统一使用一种文本框
<view class='textarea_w'>
<text class='left'>多行文本</text>
<view class='textarea left'>
<textarea placeholder='投诉内容(必填)' cursor-spacing='20' name="COMPLAIN_CONTENT" value='{{form_info}}'></textarea>
</view>
</view>
<button class='subClass_btn2' type="primary" formType="reset">重置</button>
<button class='subClass_btn2' type="primary" formType="submit">派单</button>
</form>

index.wxss页面 样式页面 没什么好看的

page{
font-size: 30rpx;
}
.left{ float: left}
.right{float: right}
.index_seach {
width: 100%;
margin-top: 20rpx;
height: auto;
margin-bottom: 30rpx;
}
/* 表单类通用 表单类通用 表单类通用*/
.input_w {
width: 100%;
height: 90rpx;
line-height: 90rpx;
/* background: lightblue; */
}

.input_w text {
display: block;
width: 20%;
text-align: center;
/* background: red; */
}

.input_w .input {
width: 75%;
height: 70rpx;
margin-top: 10rpx;
border: 1px solid #ccc;
box-sizing: border-box;
}

.input input {
margin-top: 10rpx;
margin-left: 10rpx;
/* background: lightblue; */
}


.textarea_w {
display: block;
width: 100%;
height: 180rpx;
overflow: hidden;
}

.textarea_w text {
display: block;
width: 20%;
text-align: center;
line-height: 90rpx;
}

.textarea {
width: 75%;
height: 140rpx;
margin-top: 10rpx;
border: 1px solid #ccc;
padding: 8rpx;
/* background: lightblue; */
overflow: hidden;
}

.textarea textarea {
width: 100%;
height: 130rpx;
/* background: lightcoral; */
}
/* 表单类通用 表单类通用 表单类通用*/
.subClass_btn2 {
margin-top: 40rpx;
width: 80%;
height: 80rpx;
line-height: 80rpx;
font-size: 30rpx;
color: #fff;
background: #20bd03;
background-color: #efeff4;}
.tui-picker-content{
  padding: 30rpx;
  text-align: center;
}
.tui-picker-name{
  height: 80rpx;
  line-height: 80rpx;
}
.tui-picker-detail{
  height: 80rpx;
  line-height: 80rpx;
  background-color: #fff;
  font-size: 35rpx;
  padding: 0 10px;
  overflow: hidden;
}

WxValidate.js 表单校验工具 直接在utils包下新建一个WxValidate.js,然后把代码复制进去即可

/**
 * 表单验证
 * 
 * @param {Object} rules 验证字段的规则
 * @param {Object} messages 验证字段的提示信息
 * 
 */
class WxValidate {
  constructor(rules = {}, messages = {}) {
    Object.assign(this, {
      data: {},
      rules,
      messages,
    })
    this.__init()
  }

  /**
   * __init
   */
  __init() {
    this.__initMethods()
    this.__initDefaults()
    this.__initData()
  }

  /**
   * 初始化数据
   */
  __initData() {
    this.form = {}
    this.errorList = []
  }

  /**
   * 初始化默认提示信息
   */
  __initDefaults() {
    this.defaults = {
      messages: {
        required: '这是必填字段。',
        email: '请输入有效的电子邮件地址。',
        tel: '请输入11位的手机号码。',
        url: '请输入有效的网址。',
        date: '请输入有效的日期。',
        dateISO: '请输入有效的日期(ISO),例如:2009-06-23,1998/01/22。',
        number: '请输入有效的数字。',
        digits: '只能输入数字。',
        idcard: '请输入18位的有效身份证。',
        equalTo: this.formatTpl('输入值必须和 {0} 相同。'),
        contains: this.formatTpl('输入值必须包含 {0}。'),
        minlength: this.formatTpl('最少要输入 {0} 个字符。'),
        maxlength: this.formatTpl('最多可以输入 {0} 个字符。'),
        rangelength: this.formatTpl('请输入长度在 {0} 到 {1} 之间的字符。'),
        min: this.formatTpl('请输入不小于 {0} 的数值。'),
        max: this.formatTpl('请输入不大于 {0} 的数值。'),
        range: this.formatTpl('请输入范围在 {0} 到 {1} 之间的数值。'),
      }
    }
  }

  /**
   * 初始化默认验证方法
   */
  __initMethods() {
    const that = this
    that.methods = {
      /**
       * 验证必填元素
       */
      required(value, param) {
        if (!that.depend(param)) {
          return 'dependency-mismatch'
        } else if (typeof value === 'number') {
          value = value.toString()
        } else if (typeof value === 'boolean') {
          return !0
        }

        return value.length > 0
      },
      /**
       * 验证电子邮箱格式
       */
      email(value) {
        return that.optional(value) || /^[a-zA-Z0-9.!#$%&'*+\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/.test(value)
      },
      /**
       * 验证手机格式
       */
      tel(value) {
        return that.optional(value) || /^1[34578]\d{9}$/.test(value)
      },
      /**
       * 验证URL格式
       */
      url(value) {
        return that.optional(value) || /^(?:(?:(?:https?|ftp):)?\/\/)(?:\S+(?::\S*)?@)?(?:(?!(?:10|127)(?:\.\d{1,3}){3})(?!(?:169\.254|192\.168)(?:\.\d{1,3}){2})(?!172\.(?:1[6-9]|2\d|3[0-1])(?:\.\d{1,3}){2})(?:[1-9]\d?|1\d\d|2[01]\d|22[0-3])(?:\.(?:1?\d{1,2}|2[0-4]\d|25[0-5])){2}(?:\.(?:[1-9]\d?|1\d\d|2[0-4]\d|25[0-4]))|(?:(?:[a-z\u00a1-\uffff0-9]-*)*[a-z\u00a1-\uffff0-9]+)(?:\.(?:[a-z\u00a1-\uffff0-9]-*)*[a-z\u00a1-\uffff0-9]+)*(?:\.(?:[a-z\u00a1-\uffff]{2,})).?)(?::\d{2,5})?(?:[/?#]\S*)?$/i.test(value)
      },
      /**
       * 验证日期格式
       */
      date(value) {
        return that.optional(value) || !/Invalid|NaN/.test(new Date(value).toString())
      },
      /**
       * 验证ISO类型的日期格式
       */
      dateISO(value) {
        return that.optional(value) || /^\d{4}[\/\-](0?[1-9]|1[012])[\/\-](0?[1-9]|[12][0-9]|3[01])$/.test(value)
      },
      /**
       * 验证十进制数字
       */
      number(value) {
        return that.optional(value) || /^(?:-?\d+|-?\d{1,3}(?:,\d{3})+)?(?:\.\d+)?$/.test(value)
      },
      /**
       * 验证整数
       */
      digits(value) {
        return that.optional(value) || /^\d+$/.test(value)
      },
      /**
       * 验证身份证号码
       */
      idcard(value) {
        return that.optional(value) || /^[1-9]\d{5}[1-9]\d{3}((0\d)|(1[0-2]))(([0|1|2]\d)|3[0-1])\d{3}([0-9]|X)$/.test(value)
      },
      /**
       * 验证两个输入框的内容是否相同
       */
      equalTo(value, param) {
        return that.optional(value) || value === that.data[param]
      },
      /**
       * 验证是否包含某个值
       */
      contains(value, param) {
        return that.optional(value) || value.indexOf(param) >= 0
      },
      /**
       * 验证最小长度
       */
      minlength(value, param) {
        return that.optional(value) || value.length >= param
      },
      /**
       * 验证最大长度
       */
      maxlength(value, param) {
        return that.optional(value) || value.length <= param
      },
      /**
       * 验证一个长度范围[min, max]
       */
      rangelength(value, param) {
        return that.optional(value) || (value.length >= param[0] && value.length <= param[1])
      },
      /**
       * 验证最小值
       */
      min(value, param) {
        return that.optional(value) || value >= param
      },
      /**
       * 验证最大值
       */
      max(value, param) {
        return that.optional(value) || value <= param
      },
      /**
       * 验证一个值范围[min, max]
       */
      range(value, param) {
        return that.optional(value) || (value >= param[0] && value <= param[1])
      },
    }
  }

  /**
   * 添加自定义验证方法
   * @param {String} name 方法名
   * @param {Function} method 函数体,接收两个参数(value, param),value表示元素的值,param表示参数
   * @param {String} message 提示信息
   */
  addMethod(name, method, message) {
    this.methods[name] = method
    this.defaults.messages[name] = message !== undefined ? message : this.defaults.messages[name]
  }

  /**
   * 判断验证方法是否存在
   */
  isValidMethod(value) {
    let methods = []
    for (let method in this.methods) {
      if (method && typeof this.methods[method] === 'function') {
        methods.push(method)
      }
    }
    return methods.indexOf(value) !== -1
  }

  /**
   * 格式化提示信息模板
   */
  formatTpl(source, params) {
    const that = this
    if (arguments.length === 1) {
      return function () {
        let args = Array.from(arguments)
        args.unshift(source)
        return that.formatTpl.apply(this, args)
      }
    }
    if (params === undefined) {
      return source
    }
    if (arguments.length > 2 && params.constructor !== Array) {
      params = Array.from(arguments).slice(1)
    }
    if (params.constructor !== Array) {
      params = [params]
    }
    params.forEach(function (n, i) {
      source = source.replace(new RegExp("\\{" + i + "\\}", "g"), function () {
        return n
      })
    })
    return source
  }

  /**
   * 判断规则依赖是否存在
   */
  depend(param) {
    switch (typeof param) {
      case 'boolean':
        param = param
        break
      case 'string':
        param = !!param.length
        break
      case 'function':
        param = param()
      default:
        param = !0
    }
    return param
  }

  /**
   * 判断输入值是否为空
   */
  optional(value) {
    return !this.methods.required(value) && 'dependency-mismatch'
  }

  /**
   * 获取自定义字段的提示信息
   * @param {String} param 字段名
   * @param {Object} rule 规则
   */
  customMessage(param, rule) {
    const params = this.messages[param]
    const isObject = typeof params === 'object'
    if (params && isObject) return params[rule.method]
  }

  /**
   * 获取某个指定字段的提示信息
   * @param {String} param 字段名
   * @param {Object} rule 规则
   */
  defaultMessage(param, rule) {
    let message = this.customMessage(param, rule) || this.defaults.messages[rule.method]
    let type = typeof message

    if (type === 'undefined') {
      message = `Warning: No message defined for ${rule.method}.`
    } else if (type === 'function') {
      message = message.call(this, rule.parameters)
    }

    return message
  }

  /**
   * 缓存错误信息
   * @param {String} param 字段名
   * @param {Object} rule 规则
   * @param {String} value 元素的值
   */
  formatTplAndAdd(param, rule, value) {
    let msg = this.defaultMessage(param, rule)

    this.errorList.push({
      param: param,
      msg: msg,
      value: value,
    })
  }

  /**
   * 验证某个指定字段的规则
   * @param {String} param 字段名
   * @param {Object} rules 规则
   * @param {Object} data 需要验证的数据对象
   */
  checkParam(param, rules, data) {

    // 缓存数据对象
    this.data = data

    // 缓存字段对应的值
    const value = data[param] !== null && data[param] !== undefined ? data[param] : ''

    // 遍历某个指定字段的所有规则,依次验证规则,否则缓存错误信息
    for (let method in rules) {

      // 判断验证方法是否存在
      if (this.isValidMethod(method)) {

        // 缓存规则的属性及值
        const rule = {
          method: method,
          parameters: rules[method]
        }

        // 调用验证方法
        const result = this.methods[method](value, rule.parameters)

        // 若result返回值为dependency-mismatch,则说明该字段的值为空或非必填字段
        if (result === 'dependency-mismatch') {
          continue
        }

        this.setValue(param, method, result, value)

        // 判断是否通过验证,否则缓存错误信息,跳出循环
        if (!result) {
          this.formatTplAndAdd(param, rule, value)
          break
        }
      }
    }
  }

  /**
   * 设置字段的默认验证值
   * @param {String} param 字段名
   */
  setView(param) {
    this.form[param] = {
      $name: param,
      $valid: true,
      $invalid: false,
      $error: {},
      $success: {},
      $viewValue: ``,
    }
  }

  /**
   * 设置字段的验证值
   * @param {String} param 字段名
   * @param {String} method 字段的方法
   * @param {Boolean} result 是否通过验证
   * @param {String} value 字段的值
   */
  setValue(param, method, result, value) {
    const params = this.form[param]
    params.$valid = result
    params.$invalid = !result
    params.$error[method] = !result
    params.$success[method] = result
    params.$viewValue = value
  }

  /**
   * 验证所有字段的规则,返回验证是否通过
   * @param {Object} data 需要验证数据对象
   */
  checkForm(data) {
    this.__initData()

    for (let param in this.rules) {
      this.setView(param)
      this.checkParam(param, this.rules[param], data)
    }

    return this.valid()
  }

  /**
   * 返回验证是否通过
   */
  valid() {
    return this.size() === 0
  }

  /**
   * 返回错误信息的个数
   */
  size() {
    return this.errorList.length
  }

  /**
   * 返回所有错误信息
   */
  validationErrors() {
    return this.errorList
  }
}

export default WxValidate

你可能感兴趣的:(微信小程序表单校验提交重置,及真机测试路径注意事项)