element表单使用校验之校验失效问题详解

Winola ·

更新时间:2024-11-14

· 1576 次阅读

第一种可能的错误：字段错误

第二种：触发校验错误

validator

总结

首先是html必须正确,直接看代码示例：

<el-form ref="form" :model="form" :rules="rules" label-width="80px">
  <el-form-item label="名称" prop="name">
    <el-input v-model="form.name"></el-input>
  </el-form-item>
  <el-form-item label="性别" prop="sex">
    <el-input v-model="form.sex"></el-input>
  </el-form-item>
  <el-form-item label="年龄" prop="age">
    <el-input v-model="form.age"></el-input>
  </el-form-item>
</el-form>

第一种可能的错误：字段错误

其中的每个 el-form-item 标签中，都有一个 prop ，其中的值是我们 rules 对象中的某个属性。

然后我们 v-model 绑定的值也必须是这个属性

比如我们的字段是 userName，我们的prop还是name时，校验失效

  <el-form-item label="名称" prop="name">
    <el-input v-model="form.userName"></el-input>
  </el-form-item>

再来看js中的代码：

form: {
  name: undefined,
  sex: undefined,
  age: undefined
},
rules: {
    name: [
          { required: true, message: "用户名称不能为空", trigger: "blur" },
          { min: 2, max: 20, message: '用户名称长度必须介于 2 和 20 之间', trigger: 'blur' }
        ],
    sex: [
          { required: true, message: "性别不能为空", trigger: "blur" }
        ],
    age: [
          { required: true, message: "年龄不能为空", trigger: "blur" },
          { pattern: /^([0-9]|[1-9]\d|[1-9]\d\d)$/, message: '年龄介于 0-999 之间', trigger: 'blur' }
        ]
}

第二种：触发校验错误

rules 中每个校验对象都有一项 trigger 是检验触发的方式

对 el-input 输入框的验证，trigger的值选blur，即失去焦点时进行验证。

下拉框 el-select、日期选择器 el-date-picker、复选框 el-checkbox、单选框 el-radio验证时，trigger的值选择change，即当值发生变化时就进行验证。

没有任何输入的时候，不会触发 change ，但一定会触发 blur 事件

注：如果使用了其他的组件（非ele组件等），组件中没有 v-model 等等情况时，值改变时需要我们手动去触发校验

方法名	说明	参数
validateField	对部分表单字段进行校验的方法	Function(props: array \| string, callback: Function(errorMessage: string))

this.$refs.表单ref名称.validateField(校验字段); validator

最后提一下自定义校验，用于一些校验一些复杂的值

validator的参数有：(rule, value, callback)，前三个比较重要。

rule：指向该条规则对象。

value：新的值，用于参与运算、对比。

callback：执行回调，使用方法是：callback('...');。如果不传参：表示验证通过，一般不必专门强调。

如果传入值：字符串会作为错误提示，但是显示优先级低于外层的message。比如callback('内层错误提示');跟message: '外层错误提示'同时存在，则会提示：外层错误提示。

直接看代码

data(){
  const name = (rule, value, callback) => {
    console.log(rule)
    console.log(value)
    console.log(callback)
    if (this.oldName === value) {
      callback(new Error("新名字不能和旧名字一致"));
    } else {
      callback();
    }
  };
  return {
    rules: {
        name: [
          { required: true, trigger: "blur", message: "请再次输入新名字" },
          { required: true, validator: name, trigger: "blur" }
        ]
    }
  }