vue3+ts,form表单校验实现步骤记录,与asyncValidator自定义验证规则
前言
在实际开发中,少不了要做提交表单的动作,其中必会遇到表单校验。所谓的表单校验是指在提交表单的时候,在前端校验这些表单项是否符合我们的逻辑规则,如果符合就提交给后端,否则提交失败。举个例子:比如输入账号密码,账号密码不能为空,我们前端做校验如果这两个值为空就不能进行下一步操作,下面来看看简单的表单校验是怎么实现的。
一、简单表单校验实现步骤
1.在表单组件el-form绑定ref值和model数据源,以及校验规则rules
如下代码示例:
<template>
//1.在表单组件el-form绑定ref值和model数据源,以及校验规则rules
<el-form ref="formRef" :model="form" :rules="rules" label-position="top">
<el-col :span="8">
<el-form-item label="账号" prop="userId">
<el-input v-model="form.userId" placeholder="请输入" />
</el-form-item>
</el-col>
<el-col :span="8">
<el-form-item label="密码" prop="password">
<el-input v-model="form.password" placeholder="请输入" />
</el-form-item>
</el-col>
</el-form>
<el-button size="large" type="primary" @click="submitForm">
提交
</el-button>
</template>
<script setup lang="ts">
import { FormRules, FormInstance } from 'element-plus'
import { reactive, ref } from 'vue'
const formRef = ref<FormInstance>()
//2.定义数据源
const form = reactive({
userName: '',
password: ''
})
//3.定义校验规则
const rules = reactive<FormRules>({
userName: [
{ required: true, message: '必填项目', trigger: 'blur' },
{ asyncValidator: validateCheck, trigger: 'blur' }
],
password: [{ required: true, message: '必填项目', trigger: 'blur' }]
//required为true表示必填,如果为空就提示message中的信息;如果表单项是el-select选择器的话,trigger的值为‘change’
})
//4.表单提交按钮点击触发验证方法
async function submitForm() {
await formRef.value?.validate((valid) => {
if (valid) {
//如果校验通过,执行相应的动作
}
})
}
</script>
以上代码步骤大概就是我们平时写表单校验的流程了,
二、asyncValidator自定义验证规则
有时上面的简单验证不能满足我们的需求,我们需要根据自己的逻辑判断,这时就该轮到asyncValidator出场了。asyncValidator通过接收一个自定义方法来自定义验证规则,
function(source, [options], callback): Promise
参数:
①source 要验证的对象(必选)
②[options] 验证处理选项对象(可选)
③callback 验证完成时调用的回调函数(可选)
如下代码:
const rules = reactive<FormRules>({
userName: [
{ required: true, message: '必填项目', trigger: 'blur' },
{ asyncValidator: validateCheck, trigger: 'blur' }
]
})
const validateCheck= async (rule: any, value: any, callback: any) => {
if (value === '') {
callback(new Error('用户名为空!'))
} else {
const res = await validateUserid({ userId: value })
if (res && !res.result) {
callback(new Error('用户名不存在,请先注册!'))
}
callback()
}
}