we-validator

const WeValidator = require('we-validator')

// 1. 创建验证器实例
const validator = new WeValidator({
  rules: {
    username: { required: true },
    phoneno: { required: true, mobile: true },
    email: { required: true, email: true }
  },
  messages: {
    username: { required: '请输入用户名' },
    phoneno: { required: '请输入手机号', mobile: '手机号格式不正确' },
    email: { required: '请输入邮箱', email: '邮箱格式不正确' }
  }
})

// 2. 校验数据
validator.checkData({ username: '张三', phoneno: '13800138000', email: 'test@test.com' })
// → true（校验通过）

validator.checkData({ username: '', phoneno: '123', email: 'bad' })
// → false + showToast 提示第一个错误

// 3. 校验单个字段
validator.checkValue('13800138000', 'mobile')
// → true

// 4. 动态添加规则
validator.addRules({
  age: { required: true, range: [18, 99] }
}, {
  age: { required: '请输入年龄', range: '年龄必须在 18-99 之间' }
})

// 5. 移除规则
validator.removeRules(['age'])

# npm
npm install we-validator --save

# 或 CDN（浏览器/H5）
# <script src="https://unpkg.com/we-validator/dist/we-validator.min.js"></script>

// utils/validator.js
const WeValidator = require('we-validator')

const validator = new WeValidator({
  rules: {
    name: { required: true },
    phone: { required: true, mobile: true },
    idcard: { idcard: true }  // 选填
  },
  messages: {
    name: { required: '请输入姓名' },
    phone: {
      required: '请输入手机号',
      mobile: '手机号格式不正确'
    },
    idcard: { idcard: '身份证号格式不正确' }
  }
})

module.exports = validator

// pages/form/index.js
const validator = require('../../utils/validator')

Page({
  onSubmitForm(e) {
    const { value } = e.detail

    if (!validator.checkData(value)) return

    // 校验通过，提交表单
    wx.request({
      url: 'https://api.example.com/submit',
      data: value,
      method: 'POST'
    })
  }
})

const validator = new WeValidator({
  rules: { username: { required: true } },
  messages: { username: { required: '请输入用户名' } },
  // 自定义错误展示方式（替代默认 showToast）
  onMessage: (errors) => {
    // errors 是数组，包含所有校验失败的字段
    errors.forEach(err => {
      console.log(`${err.field}: ${err.message}`)
    })
    // 使用自定义弹窗
    wx.showModal({
      title: '提示',
      content: errors[0].message,
      showCancel: false
    })
  }
})

// 注册自定义规则
WeValidator.addRule('password', (value, param) => {
  // 密码：8-20位，至少包含字母和数字
  return /^(?=.*[A-Za-z])(?=.*\d)[A-Za-z\d]{8,20}$/.test(value)
})

// 使用自定义规则
const validator = new WeValidator({
  rules: {
    pwd: { required: true, password: true }
  },
  messages: {
    pwd: {
      required: '请输入密码',
      password: '密码需 8-20 位，包含字母和数字'
    }
  }
})