vue 表单校验(二)

vue 表单校验(二)

vue element-ui表单校验

由于现在使用element-ui进行form表单校验,因而使用其自带的校验规则进行校验,发现有些并不是那么好校验,或者说是校验起来很繁琐,因而一直在研究中

表单校验分类

前后端校验

  • 前端校验
  • 后端校验
    这种目前一般是结合起来使用,很少单纯前端校验,或者单纯后端校验的

前端检验

  • 数据录入时校验
  • 数据回显时校验
  • 动态创建时校验
  • 数据是否必填时校验

接下来所谈论的校验都是基于前端进行校验,若是后天校验,只是统一校验规则而已,这样前后便可以统一了。其实这里并不是很简单,但是不得不细心,而已最好,前后台都要其校验规则,以及校验话术放在一个公共的地方,避免在每个具体文件内进行修改。若是能更好的话,类似 google email 那样,通过后台返回规则类型,以及对应前台的具体编号,进行显示即可(比如1: 不能为空, 2:校验规则不合…) 这样的好处,前台只认这个数字即可,不然后台返回什么,前台出什么错误,都是统一显示(这个扯远了),讲今天的重点

基于 element-ui 自带的 表单校验

  • 数据录入时校验

element-ui form validate

  • el-form 标签
    • 属性
      • model 对象却只能是一维 { a: 1, b: 2 }, 不能是 { a: { b: 2 } }, 不然关联不到
      • rules 按照规则要求即可
      • ref 提交表单时触发
  • el-form-item 标签 必须使用这个进行包裹 表单框… 校验才会有效
    • 属性
      • prop 只有标识了这个才会进入校验
<template>
  <el-form
    :model="ruleForm"
    ref="ruleForm"
    label-width="100px"
    :rules="rules">
    <el-form-item
      label="活动名称"
      prop="name">
      <el-input v-model="ruleForm.name"></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>  
</template>

<script>
  ...
  data () {
    const isNum = (rule, value, callback) => { // 参数顺序必须如
      let reg = /^[0-9]{5,20}$/;
      if (reg.test(value)) {
        callback()
      } else {
        callback(new Error("不是数据"))
      }
    }

    return {
      ruleForm: {
        name: ''
      },
      rules: {
        name: [
          {
            required: true,      // 用来设置是否必填
            message: '不能为空',  // 错误信息展示
            trigger: 'blur'      // 触发校验事件
          },
          {
            min: 3,  
            max: 5,
            message: '长度在 3 到 5 个字符',
            trigger: 'blur'
          },
          {
            validator: isNum,    // 自定义校验
            trigger: ['blur', 'change']  // 填写 blur change时,可以达到类似 input事件,实时进行校验
          }
        ]
      }
    }
  },
  methods: {
    /**
     * 表单提交
     */
    submitFomr (formName) {
      this.$refs[formName].validate(valid => {
        if (valid) {
          alert('success')
        } else {
          alert('error')
        }
      })
    },
    /** 
     * 重置表单
     */
    resetForm (formName) {
      this.$refs[formName].resetFields()
    }
  }
</script>

以上是一个正常表单的大致模型

  • 数据回显时校验

主要是数据返回时,要不要触发校验

  • 不触发 github 这里有一些解释,不是很好弄
  • 触发 (跟产品沟通过,倾向于这种)
    当前基于数据反显时就触发校验
setFormData () {
 setTimeout(() => {
   this.ruleForm = {
     name: '测试项目',
     region: 2,
     type: [1, 2],
     resource: 1,
     desc: '测试数据回显时校验颜色变化问题'
   }

   this.$nextTick(() => {
     // 为了回显时,不只是el-select 校验被触发
     this.$refs.ruleForm.validate()
   })
 }, 1500)
  • 动态创建时校验

    有时候需要动态创建一个输入框时,也需要检验,这时候就需要动态校验,不然一直卡着过不去

<el-row
  class="sc-row"
  :gutter="20"
  v-for="(t, i) in ruleForm.contactList"
  :key="t.id">
  <!-- :key="i" 没问题; :key="t.id" 时,不会变亮  ==== 没必要在第一次赋值时给id,新增时再给即可-->
  <el-col :span="8">
    <el-form-item
      label="姓氏"
      :prop="'contactList.' + i +'.family_name'"
      :rules="[
            { required: true, message: '不能为空', trigger: ['blur', 'change']}
          ]">
      <el-input v-model="t.family_name"></el-input>
    </el-form-item>
  </el-col>
  <el-col :span="8">
    <el-form-item
      label="名字"
      :prop="'contactList.' + i +'.contact_name'"
      :rules="[
            {required: true, message: '不能为空', trigger: ['blur', 'change']}
          ]">
      <el-input v-model="t.contact_name"></el-input>
    </el-form-item>
  </el-col>
  <el-col :span="8">
    <el-button @click.prevent="deleteConcats(t)">删除</el-button>
  </el-col>
</el-row>

重点,切记切记

  • 循环 v-for == v-for = '(item, i) in list' :key="item.id" i
  • el-form-item 属性
    • :prop = "contactList.${i}.contact_name"
    • :rules="[{{required: true, message: '不能为空', trigger: ['blur', 'change']}]" 写相应的校验规则
  • 删除已添加的表单
    • v-for 绑定时,:key="item.id" 使用对应值的id,而不是对应的索引i
    addConcats () {
      this.ruleForm.contactList.push({
        family_name: '',
        contact_name: '',
        id: Date.now() //  还是需要使用,这样可以 避免校验触发时,删除后却没有变化
      })
    },
    deleteConcats (item) {
        const List = this.ruleForm.contactList
        const index = List.findIndex((val) => {
          return item === val
        })
        List.splice(index, 1)
      }
    }
  • 数据是否必填时校验
<el-form-item
  label="是不是必填"
  prop="isRequire"
  :rules="[
    {required: isRequire, message: '请填写', trigger: 'blur'}
  ]">
  <el-input v-model="ruleForm.isRequire"></el-input>
</el-form-item>

是否选填,个人建议直接以动态form表单形式进行展示,这样便可以通过 { reuired: isRequire }isRequire Boolean类型

总结

至此,大致的form表单校验就差不多了,虽然看起来很简单,但是也是我不断采坑过来的,在此,我更加推荐使用 element-ui-verify,里面有详细的文档,多多关注即可

  • 当前校验的缺点
    • 动态创建
    <el-row class="sc-row" :gutter="20" v-for="(t, i) in ruleForm.contactList" :key="t.id">
      <el-col :span="8">
        <el-form-item
          label="姓氏"
          :prop="'contactList.' + i +'.family_name'"
          :rules="[
            { required: true, message: '不能为空', trigger: ['blur', 'change']}
          ]">
          <el-input v-model="t.family_name"></el-input>
        </el-form-item>
      </el-col>
      <el-col :span="8">
        <el-form-item
          label="名字"
          :prop="'contactList.' + i +'.contact_name'"
          :rules="[
            {required: true, message: '不能为空', trigger: ['blur', 'change']}
          ]">
          <el-input v-model="t.contact_name"></el-input>
        </el-form-item>
      </el-col>
      <el-col :span="8">
        <el-button @click.prevent="deleteConcats(t)">删除</el-button>
      </el-col>
    </el-row>

    上面的 姓氏和名字 同为中文或英文时,很难进行判断 element密码两次是否相同,但是当前动态创建时,无法传递索引,自定义方法中无法进行传参,导致拿不到同一索引下的姓氏跟名字,也就无法进行匹配判断了

  • 其他注意细节
    • 在自定义验证里面每一个判断都要有callback(),就是要保证callback()一定会执行到,不然既不报错,也不提交代码,令人很是无语
    • async-validator
    • 上面例子的code

到此,算是一个给自己年末去心病吧,这个困惑我太久了,到现在想想都恐怖,算是简单补充下吧,后期再多多注意

在此抛出几个问题,留给自己思考

  • 大型表单时,哪儿错误,自动定位到哪儿,同时 focus
  • 统一错误信息,后台传给前台具体id,以供前台进行错误信息展示,这个前台统一管理
  • 考虑使用其他校验插件,多多扩充自己的脑容量