【ElementPlus】el-form使用技巧:动态切换校验规则的最佳实践
喵~
今天分享一篇在 ElementPlus 中使用 el-form 动态切换校验规则 的实用方法。
一、问题概述
作为前端开发人员,在开发项目中,特别是后台管理系统,表单的使用是必不可少的。当业务需求复杂时,常常需要根据不同的参数动态切换校验规则。
当动态切换校验规则时,可能会出现一些意想不到的状况,
比如:
问题 1
- 如果触发了一个规则,表单报红后没有reset,再切换新规则,则原有规则的报红依旧显示的问题;
问题 2
- 表单会主动触发新规则的校验,导致表单直接报红;
根据上述2个问题,解决方案如下:
二、项目配置
名称 | 版本 |
---|---|
element-plus | ^2.8.8 |
vue | ^3.5.12 |
typescript | ~5.6.3 |
这里采用了 vue + ts 的开发方式,不喜欢 ts 的小伙伴可以根据项目自行删除不需要的代码~
三、解决方案
整体代码是在 ElementPlus form 校验功能模块的基础上进行优化升级的~
代码做了精简,重点突出解决方案的代码~
源码在此处:https://element-plus.org/zh-CN/component/form.html
项目引入必要代码
import { reactive, ref } from 'vue'
import type { ComponentSize, FormInstance, FormRules } from 'element-plus'
接下来进行优化升级:
1. 定义规则
(1)TS接口
interface IRuleFormOne {
name: string
region: string
count: string
}
interface IRuleFormTwo {
delivery: boolean
location: string
type: string[]
resource: string
desc: string
}
/**
* 此处需要汇总一个完整规则,用于整体表单
*/
interface RuleForm extends IRuleFormOne, IRuleFormTwo{}
(2)规则
const rulesOne = reactive<FormRules<IRuleFormOne>>({
name: [
{ required: true, message: 'Please input Activity name', trigger: 'blur' },
{ min: 3, max: 5, message: 'Length should be 3 to 5', trigger: 'blur' },
],
region: [
{
required: true,
message: 'Please select Activity zone',
trigger: 'change',
},
],
count: [
{
required: true,
message: 'Please select Activity count',
trigger: 'change',
},
],
})
const rulesTwo = reactive<FormRules<IRuleFormTwo>>({
location: [
{
required: true,
message: 'Please select a location',
trigger: 'change',
},
],
type: [
{
type: 'array',
required: true,
message: 'Please select at least one activity type',
trigger: 'change',
},
],
resource: [
{
required: true,
message: 'Please select activity resource',
trigger: 'change',
},
],
desc: [{ required: true, message: 'Please input activity form', trigger: 'blur' }],
})
/**
* 可以先给表单赋一个初始规则
*/
const rules = ref<FormRules>(rulesOne)
2. 表单值
const ruleForm = reactive<RuleForm>({
name: 'Hello',
region: '',
count: '',
delivery: false,
location: '',
type: [],
resource: '',
desc: '',
})
3. 功能按钮
这里不是重点,用什么切换都可以,此处我用了两个普通按钮,并定义了 handleClickRule 方法来切换规则
/**
* Template部分
*/
<el-button-group class="rule-btn-group">
<el-button :type="actBtn === 1 ? 'primary' : ''" @click="handleClickRule(1)">规则一</el-button>
<el-button :type="actBtn === 2 ? 'primary' : ''" @click="handleClickRule(2)">规则二</el-button>
</el-button-group>
/**
* TS部分
*/
const actBtn = ref(1)
4. 实现切换规则
解决问题1
/**
* 这里是 Element Plus 原有代码,不需要优化,只是后面会用到,所以直接展示在这里
*/
const resetForm = (formEl: FormInstance | undefined) => {
if (!formEl) return
formEl.resetFields()
}
/**
* 重点在这里!
*/
function handleClickRule(idx: number) {
actBtn.value = idx
switch (idx) {
case 1:
/**
* 这一行很关键,解决问题1,切换前,先清除已有的报红
*/
resetForm(ruleFormRef.value)
rules.value = rulesOne
break
case 2:
resetForm(ruleFormRef.value)
rules.value = rulesTwo
break
default:
break
}
}
解决问题2
el-form 添加一条属性配置即可解决:
<el-form
ref="ruleFormRef"
style="max-width: 600px"
:model="ruleForm"
:rules="rules"
label-width="auto"
:size="formSize"
status-icon
:validate-on-rule-change="false"
>
官方提供了现成的解决方案,原出处说的很清楚:
完整操作效果展示:
四、结语
至此,问题1、2都完美解决,其实很多功能看文档就能够解决大部分问题了。
有任何问题的小伙伴可以留言交流~