关于ElementPlus中的表单验证

关于ElementPlus中表单的校验规则，官网文档已经给出了，但是没有说明性文字，所以我想来记录一下，给出一些文字说明

ElementPlus中的简单校验

ElementPlus的表单的一般结构是：

<el-form>
	<el-form-item>
		<el-input/>
	</el-form-item>
</el-form>

ElementPlus中使用表单校验规则：

在<script>中给出校验规则对象，主要属性名要与form对象的属性名一致
一个字段的校验规则可以有多个，值是一个数组，数组中的一个对象就是一条校验规则

// 收集表单数据
const form = reactive({
  account: '',
  password: '',
  agree: false
})

// 定义校验规则
// 可以为一个字段指定多条校验规则
// 规则名称与form表单字段一致
const rules = reactive({
  account: [
    // required是否必填,message不符合此规则时的提示信息,
    // trigger触发此条规则校验的时机，有两个值, blur 或 change,默认就是blur和change都会进行校验
    // min此字段的最小长度，max此字段的最大长度
    // pattern 正则表达式
    { required: true, message: '账户不能为空', trigger: 'blur' },
    { min: 6, max: 14, message: '用户名长度为6 - 14位' }
  ]
})

在模版中:

<el-form>中rules属性绑定规则校验对象
<el-form-item>中prop属性绑定规则对象的某个字段

<!--
  :model 绑定表单对象
  :rules 绑定表单的校验规则
-->
<el-form
  status-icon
  :model="form"
  :rules="rules"
>
  <!--
	label标签名
	prop属性,指定校验规则中的
  -->
  <el-form-item label="账户" prop="account">
	<!-- v-model将值收集到哪个变量中 -->
	<el-input v-model="form.account" />
  </el-form-item>

  <el-form-item label="密码">
	<el-input v-model="form.password" />
  </el-form-item>

  <el-button size="large" class="subBtn">点击登录</el-button>
</el-form>

演示效果
关于ElementPlus中的表单验证-LMLPHP

自定义校验规则

在<script>中的规则中，数组中的每一个对象都是一个校验规则，我们只需要给一个对象给出validator()方法的实现即可:
该方法有三个参数：

validator(rule, value, callback){
	// rule此条规则的描述信息
	// value表单中此字段的值
	// 回调函数,通过此函数控制是否校验通过
}

看个例子

// 定义校验规则
const rules = reactive({
// 普通的校验规则
  account: [
    { required: true, message: '账户不能为空', trigger: 'blur' },
    { min: 6, max: 14, message: '用户名长度为6 - 14位' }
  ],

  password: [
  // 自定义校验规则
    {
      validator(rule, value, callback) {
        if (value[0] === '0') {
	      // 校验不通过
          return callback(new Error('密码字段的第一位不能是0'))
        } else {
          // 校验通过
          callback()
        }
      }
    }
  ]

})

在模版中使用为字段使用此条校验规则

<el-form
  :model="form"
  :rules="rules"
>
  <!--
	label标签名
	prop属性,指定校验规则中的
  -->
  <el-form-item label="账户" prop="account">
	<!-- v-model将值收集到哪个变量中 -->
	<el-input v-model="form.account" />
  </el-form-item>
  <el-form-item label="密码" prop="password">
	<el-input v-model="form.password" />
  </el-form-item>
  <el-button size="large" class="subBtn">点击登录</el-button>
</el-form>

演示效果
关于ElementPlus中的表单验证-LMLPHP

表单统一校验

如果用户什么都不输入，直接点击登录，那么每个字段的校验规则是不生效的，因为此字段还没有输入。
为了避免用户在不操作表单的情况下，直接提交表单，可以在用户点击提交按钮后，对所有的字段重新激活一次校验。
通过表单对象的一个方法validate()方法，对整个表单的所有内容进行一次验证。

form.validate(callback)

此方法接收一个回调函数，回调函数的第一个参数，是布尔类型，当所有的校验规则都通过时，此值是true，否则false
回调函数的第二个参数是校验未通过的所有字段的数组
在form表单中通过ref属性标识一下

<el-form ref="formRef">
</el-form>

<script>部分

// 获取form表单引用
const formRef = ref(null)
// 当点击登录按钮时的函数
const submit = () => {
  // 获取到真正的表单元素
  formRef.value.validate((isValid, invalidFields) => {
    if (isValid) {
      // 表单所有元素验证通过，可以提交了
      console.log('验证通过')
    } else {
      console.log(invalidFields)
      console.log('验证不通过,不能提交,请检查')
    }
  })
}

秋天code