微信小程序+vant weapp表单数据双向绑定并实现表单校验

文章讲述了在使用vant开发微信小程序时,如何解决van-field输入框值改变后绑定值未同步的问题,以及如何利用WxValidate进行表单验证,包括自定义验证规则和错误提示的处理。
摘要由CSDN通过智能技术生成

在用vant开发小程序过程中,发现van-field输入框中值改变之后,绑定的值并没有随着改变,需要手动绑定。

简单写一下实现方案

如下以输入框,和下拉选择为例

<view class="goods-base">
     <van-field label="安检通道号" name="checkPointName" value="{{ formData.checkPointName }}" data-name="checkPointName" error-message="{{checkData.checkPointName}}" required readonly right-icon="arrow" input-align="right" bind:click-input="onSelectCheckPointPicker" />
     <van-field label="安检员工号" name="jobNo" value="{{ formData.jobNo }}" data-name="jobNo" error-message="{{checkData.jobNo}}" required placeholder="请填写" input-align="right" bind:input="inputValue" />
</view>
import WxValidate from '@/utils/WxValidate';
Page({
    data:{
        formData:{
            checkPointName: '',
            jobNo: ''
        },
        checkData: {}, // 校验错误提示
        rules:{
            checkPointName: { required: true },
            jobNo: { required:true }
        },
        message:{
            checkPointName: { required: '请选择' },
            jobNo: { required:'请填写' }
        }
    },
    // 获取输入值
    inputValue(e) {
        const param = e.currentTarget.dataset.name; //字段名 
        const value = e.detail; //值 
        const key=`formData.${param}`;
        const msg=`checkData.${param}`;
        this.setData({
          [key]:value,
          [msg]:'' //清空错误提示
        })
    },
    initValidate() {
        let rules = this.data.rules; 
        let message =  this.data.message;
        //实例化当前的验证规则和提示消息
        this.WxValidate = new WxValidate(rules, message); 
    },
    checkFormData(params){
        //清空所有错误提示
        this.setData({
          checkData:{}
        })
        let check = false;
        this.initValidate();
        check = this.WxValidate.checkForm(params);
        if (!check) {
            //表单元素验证不通过,此处给出相应提示
            let error = this.WxValidate.errorList;
            error.forEach((item)=>{
              const element = item;
              const name = `checkData.${element.param}`;
              this.setData({
                [name]:element.msg
              })
            })
            return false;
        }else{
            return true;
        }
    },
    onLoad(options) {
        this.initValidate();
    },
})

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) {
        if(this.rules.hasOwnProperty(param)){
            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;

微信小程序使用 Vant 组件库的侧边导航栏滚动,需要首先在项目中引入 Vant 组件库,并且按照 Vant 的文档进行组件的配置和使用。 首先,在项目根目录下的 `app.json` 文件中配置 Vant 组件的全局样式,示例如下: ```json { "style": "vant-weapp/dist/common/index" } ``` 然后在需要使用侧边导航栏滚动的页面中引入 Vant 的侧边导航栏组件,并按照需求设置好相关属性和事件,示例如下: ```html <van-sidebar show="{{ true }}" width="200rpx" :style="height: 100vh;"> <van-sidebar-item v-for="(item, index) in menuList" :key="index" :title="item.title" :dot="item.dot" :badge="item.badge" /> </van-sidebar> ``` 其中,`show` 属性用于控制侧边导航栏的显示与隐藏,`width` 属性用于设置导航栏的宽度,`:style` 属性用于设置导航栏的高度为可视区域的高度。 此外,需要根据实际需求在 `data` 数据中定义 `menuList` 数组,并为每个侧边导航栏项设置相应的标题、角标和小红点。 最后,在页面的生命周期函数中,通过监听滚动事件来实现侧边导航栏的滚动效果,示例如下: ```javascript Page({ onScroll: function(event) { // 根据滚动位置处理侧边导航栏的样式 } }) ``` 在监听滚动事件中,可以根据滚动位置来处理侧边导航栏的样式,例如高亮当前正在滚动的导航项。 总结起来,要在微信小程序使用 Vant 组件库的侧边导航栏滚动,需要首先引入 Vant 组件库并进行配置,然后在页面中按照需求引入侧边导航栏组件并设置相应的属性和事件,最后在监听滚动事件中处理导航栏的样式即可。
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值