# zylUseFormValids 全局表单字段校验

# 用途

可以用于优化以下使用自定义表单校验场景:

<template>
  <div>
    <el-form
      :model="ruleForm"
      status-icon
      :rules="rules"
      ref="ruleForm"
      label-width="100px"
      class="demo-ruleForm"
    >
      <el-form-item label="密码" prop="pass">
        <el-input
          type="password"
          v-model="ruleForm.pass"
          autocomplete="off"
        ></el-input>
      </el-form-item>
      <el-form-item label="确认密码" prop="checkPass">
        <el-input
          type="password"
          v-model="ruleForm.checkPass"
          autocomplete="off"
        ></el-input>
      </el-form-item>
      <el-form-item label="年龄" prop="age">
        <el-input v-model.number="ruleForm.age"></el-input>
      </el-form-item>
      <el-form-item>
        <el-button type="primary" @click="submitForm('ruleForm')">
          提交
        </el-button>
        <el-button @click="resetForm('ruleForm')">重置</el-button>
      </el-form-item>
    </el-form>
  </div>
</template>
<script>
export default {
  data() {
    var checkAge = (rule, value, callback) => {
      if (!value) {
        return callback(new Error('年龄不能为空'))
      }
      setTimeout(() => {
        if (!Number.isInteger(value)) {
          callback(new Error('请输入数字值'))
        } else {
          if (value < 18) {
            callback(new Error('必须年满18岁'))
          } else {
            callback()
          }
        }
      }, 1000)
    }
    var validatePass = (rule, value, callback) => {
      if (value === '') {
        callback(new Error('请输入密码'))
      } else {
        if (this.ruleForm.checkPass !== '') {
          this.$refs.ruleForm.validateField('checkPass')
        }
        callback()
      }
    }
    var validatePass2 = (rule, value, callback) => {
      if (value === '') {
        callback(new Error('请再次输入密码'))
      } else if (value !== this.ruleForm.pass) {
        callback(new Error('两次输入密码不一致!'))
      } else {
        callback()
      }
    }
    return {
      ruleForm: {
        pass: '',
        checkPass: '',
        age: ''
      },
      rules: {
        pass: [{ validator: validatePass, trigger: 'blur' }],
        checkPass: [{ validator: validatePass2, trigger: 'blur' }],
        age: [{ validator: checkAge, trigger: 'blur' }]
      }
    }
  },
  methods: {
    submitForm(formName) {
      this.$refs[formName].validate((valid) => {
        if (valid) {
          alert('submit!')
        } else {
          console.log('error submit!!')
          return false
        }
      })
    },
    resetForm(formName) {
      this.$refs[formName].resetFields()
    }
  }
}
</script>

# 安装

  • 全量引入的 zylUI 组件会通过 Vue.prototype.$zylUseFormValids 原型链自动注册如下表格列举的表单字段校验函数,不需要单独注册

  • 按需引入的方式需要单独注册

//main.js

// 按需引入
import { zylUseFormValids } from '@zuiyouliao/zyl-ui'
Vue.use(zylUseFormValids)

# 基础用法

this.$zylUseFormValids[表单校验方法名](参数)

复制代码
<template>
  <div>
    <el-form
      :model="ruleForm"
      :rules="rules"
      ref="ruleForm"
      class="demo-ruleForm"
    >
      <el-form-item label="姓名(中/英)" prop="name">
        <el-input v-model="ruleForm.name"></el-input>
      </el-form-item>
      <el-form-item label="联系方式(手机号/固话)" prop="phone">
        <el-input v-model="ruleForm.phone"></el-input>
      </el-form-item>
      <el-form-item label="身份证号" prop="idcard">
        <el-input v-model="ruleForm.idcard"></el-input>
      </el-form-item>
      <el-form-item label="验证码" prop="code">
        <el-input v-model="ruleForm.code"></el-input>
      </el-form-item>
      <el-form-item label="余额(元)" prop="balance">
        <el-input v-model="ruleForm.balance"></el-input>
      </el-form-item>
      <el-form-item label="开始时间" prop="begntime">
        <el-date-picker
          v-model="ruleForm.begntime"
          placeholder="选择开始时间"
          class="dataPicker"
        />
      </el-form-item>
      <el-form-item label="结束时间" prop="endtime">
        <el-date-picker
          v-model="ruleForm.endtime"
          placeholder="选择结束时间"
          class="dataPicker"
        />
      </el-form-item>
      <el-form-item label="出生日期" prop="brdy">
        <el-date-picker
          v-model="ruleForm.brdy"
          :picker-options="pickerOptions"
          type="date"
          placeholder="选择日期"
        />
      </el-form-item>
      <el-form-item>
        <el-button type="primary" @click="submitForm('ruleForm')">
          提交
        </el-button>
        <el-button @click="resetForm('ruleForm')">重置</el-button>
      </el-form-item>
    </el-form>
  </div>
</template>
<script>
export default {
  data() {
    return {
      ruleForm: {
        name: '',
        phone: '',
        idcard: '',
        balance: '',
        code: '',
        begntime: '',
        endtime: '',
        brdy: '',
      },
      pickerOptions: {
        // < 当前日期之前不可选(不含当前日期)
        // <= 当前日期之前不可选(含当前日期)
        // > 当前日期之后不可选(不含当前日期)
        // >= 当前日期之后不可选(含当前日期)
        // = 只能选择当前日期
        ...this.$zylUseFormValids.validateDisabledDate('>'), //当前时间之后不可选(不包含当前日期)
      },
      rules: {
        name: [
          { required: true, message: '请输入姓名(中/英)', trigger: 'blur' },
          { validator: this.$zylUseFormValids.validateCN, trigger: 'blur' },
          {
            validator: this.$zylUseFormValids.validateTextLength(8),
          },
        ],
        phone: [
          {
            required: true,
            message: '请输入联系方式(手机号/固话)',
            trigger: 'blur',
          },
          {
            validator: this.$zylUseFormValids.validateContact,
            trigger: 'blur',
          },
        ],
        idcard: [
          {
            required: true,
            message: '请输入身份证号',
            trigger: 'blur',
          },
          { validator: this.$zylUseFormValids.validateIdCard, trigger: 'blur' },
        ],
        code: [
          {
            required: true,
            message: '请输入验证码',
            trigger: 'blur',
          },
          {
            validator: this.$zylUseFormValids.validateTextLength(4),
          },
        ],
        balance: [
          {
            required: false,
            message: '请输入余额',
            trigger: 'blur',
          },
          {
            validator: this.$zylUseFormValids.validateTrueNum,
            trigger: 'blur',
          },
        ],
        // 开始时间和结束时间联动检验
        ...this.$zylUseFormValids.validateTimeRange({
          getRef: () => this.$refs.ruleForm,
          start: 'begntime',
          end: 'endtime',
          startLabel: '开始时间',
          endLabel: '结束时间',
          required: false,
        }),
        brdy: [
          {
            required: true,
            message: '请选择出生日期',
            trigger: 'change',
          },
        ],
      },
    }
  },
  methods: {
    submitForm(formName) {
      this.$refs[formName].validate((valid) => {
        if (valid) {
          this.$zylUseToast({ message: '提交成功!' })
        } else {
          this.$zylUseToast({ message: '提交失败,请检查表单项!' })
          return false
        }
      })
    },
    resetForm(formName) {
      this.$refs[formName].resetFields()
    },
  },
}
</script>

<style lang="scss" scoped></style>
显示代码

# 方法

上次更新: 1/6/2025, 9:59:46 AM