elementUI动态嵌套el-form表单校验举例详解

 更新时间:2023年06月02日 09:12:47   作者:小绵杨Yancy  
最近工作遇到个需求,表单可以进行增加删除操作,需要进行表单校验,这篇文章主要给大家介绍了关于elementUI动态嵌套el-form表单校验的相关资料,文中通过图文介绍的非常详细,需要的朋友可以参考下

一、基础表单校验

前端项目开发过程中表单校验是非常常见的需求,elementUI的el-form组件也是支持配置rules属性来配置表单项的校验。

Form 组件允许你验证用户的输入是否符合规范,来帮助你找到和纠正错误。
Form 组件提供了表单验证的功能,只需为 rules 属性传入约定的验证规则,并将 form-Item 的 prop 属性设置为需要验证的特殊键值即可。

例如:

不要漏掉el-from-item的prop属性,需要和rules对象中的属性字段对应。

定义rules对象:

提交表单时验证规则:

校验是通过调用表单实例(表单组件上的ref属性绑定的变量)上的validate方法来实现的(异步)

这样,在我们进行验证时,如果表单项不符合rules中的规则,那么就会在对应的表单项下面提示我们设定的提示信息。

校验规则

elementUI中el-from校验的规则是引用的https://github.com/yiminghe/async-validator

比较常用的规则属性有:

必填:required

可以赋值一个boolean值,true表示必填。

类型:type

赋值有一个字符,表示要验证的内容的类型:string、number等,详情见下图:

正则验证:pattern

如果对于type无法验证的值,我们可以使用pattern赋值一个正则表达式来更加灵活的验证规则。

验证前转换:transform

有时有必要在验证之前转换一个值,可以使用tansform属性,是一个函数,参数是要验证的值,该函数的返回值是处理后再验证的值。

例如上面代码name的校验中就用到了这几个属性,其中transform会将用户输入的内容去掉字符串首位空格(trim方法)后再进行其他规则验证。

 name: {
    type: 'string',
    required: true,
    pattern: /^[a-z]+$/,
    transform(value) {
      return value.trim();
    },
 }

二、动态嵌套表单校验

了解了基础的表单校验,那么有的时候会遇到比较复杂的表单对象,并且可能需要动态增加表单项。

elementUI官网给出了一个比较简单的例子:添加/删除表单项

在此基础上,我增加了一下表单对象的复杂度。

可以看到,domains数组每个对象下包含了info对象属性,info对象下有name和intro属性,是一个嵌套的对象,并且我们可以动态的新增和删除domains中的对象,那么在表单中该如何验证呢?

本质上,检验是通过设置的rules对象中的属性,去匹配表单项上设置的prop,然后对双向绑定的内容进行验证。

首先,我们设置rules对象:

直接按照表单对象的层级设置属性即可,因为domains数组中的对象肯定是公用一套规则的。

可以看到,我们直接循环domains数组,然后通过设置prop="'domains.' + index + '.value'"来实现数组中的每个对象独立校验。
接着我们还要在每个表单项el-form-item上定义对应的rules,就能达到新增的表单项也能够校验的目的了。

效果:

三、示例源码

代码基于vue3 + ts,项目中如果安装并注册了elemetPlus,可以直接cv查看效果。

<template>
    <div class="form-box">
        <el-form ref="formRef" :model="dynamicValidateForm" label-width="120px" :rules="rules">
            <div class="inner-form-box">
                <el-form-item prop="email" label="Email📮">
                    <el-input v-model="dynamicValidateForm.email" />
                </el-form-item>
            </div>
            <div v-for="(domain, index) in dynamicValidateForm.domains" :key="domain.key" class="inner-form-box">
                <span>{{ `网站${index + 1}💌:` }}</span>
                <el-form-item label="网站域名:" :prop="'domains.' + index + '.value'" :rules="rules.domains.value">
                    <el-input v-model="domain.value" />
                </el-form-item>
                <div>
                    <span>{{ `网站${index + 1}详情📃:` }}</span>
                    <el-form-item label="网站名称:" :prop="'domains.' + index + '.info.name'" :rules="rules.domains.info.name">
                        <el-input v-model="domain.info.name" />
                    </el-form-item>
                    <el-form-item label="网站简介:" :prop="'domains.' + index + '.info.intro'"
                        :rules="rules.domains.info.intro">
                        <el-input v-model="domain.info.intro" />
                    </el-form-item>
                </div>
                <div class="del-btn-box">
                    <el-button type="danger" link @click="removeDomain(domain)">删除</el-button>
                </div>
            </div>
            <el-form-item>
                <el-button type="primary" @click="submitForm(formRef)">Submit</el-button>
                <el-button @click="addDomain">New domain</el-button>
                <el-button @click="resetForm(formRef)">Reset</el-button>
            </el-form-item>
        </el-form>
    </div>
</template>
<script lang="ts" setup>
import { reactive, ref } from 'vue'
import type { FormInstance } from 'element-plus'
const formRef = ref<FormInstance>()
const dynamicValidateForm = reactive<{
    domains: DomainItem[]
    email: string
}>({
    domains: [
        {
            key: 1,
            value: '',
            info: {
                name: '',
                intro: ''
            }
        },
    ],
    email: '',
})
const rules = {
    email: [
        {required: true,message: '邮箱地址不能为空哦',trigger: 'blur',},
        {type: 'email',message: '请输入正确的邮箱格式',trigger: ['blur', 'change'],},
    ],
    domains: {
        value: {required: true,message: '网站域名不能为空哦',trigger: 'blur',},
        info: {
            name: {required: true,message: '网站名称不能为空哦',trigger: 'blur',},
            intro: {required: true,message: '网站简介不能为空哦',trigger: 'blur',}
        }
    }
}
interface DomainItem {
    key: number
    value: string
    info: {
        name: string
        intro: string
    }
}
const removeDomain = (item: DomainItem) => {
    const index = dynamicValidateForm.domains.indexOf(item)
    if (index !== -1) {
        dynamicValidateForm.domains.splice(index, 1)
    }
}
const addDomain = () => {
    dynamicValidateForm.domains.push({
        key: Date.now(),
        value: '',
        info: {
            name: '',
            intro: ''
        }
    })
}
const submitForm = (formEl: FormInstance | undefined) => {
    if (!formEl) return
    formEl.validate((valid) => {
        if (valid) {
            console.log(dynamicValidateForm)
        } else {
            console.log('error submit!')
            return false
        }
    })
}
const resetForm = (formEl: FormInstance | undefined) => {
    if (!formEl) return
    formEl.resetFields()
}
</script>
<style scoped>
.form-box {
    padding: 50px;
}
.inner-form-box {
    position: relative;
    padding: 10px;
    margin-bottom: 10px;
    box-shadow: 0px 0px 5px 0px #f2f2f2;
}
.del-btn-box {
    position: absolute;
    right: 0;
    top: 0;
    transform: translateX(120%);
}
</style>

总结

到此这篇关于elementUI动态嵌套el-form表单校验的文章就介绍到这了,更多相关elementUI动态嵌套表单校验内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Vue中动态绑定Ref的两种方式总结

    Vue中动态绑定Ref的两种方式总结

    Vue3中的ref是一种创建响应式引用的方式,它在Vue生态系统中扮演着重要角色,下面这篇文章主要给大家介绍了关于Vue中动态绑定Ref的两种方式,需要的朋友可以参考下
    2024-09-09
  • Vue分页器实现原理详解

    Vue分页器实现原理详解

    这篇文章主要为大家详细介绍了Vue分页器实现原理,编写了分页器组件,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-06-06
  • 深入了解Vue动态组件和异步组件

    深入了解Vue动态组件和异步组件

    这篇文章主要介绍了深入了解Vue动态组件和异步组件的相关资料,帮助大家更好的理解和学习vue组件的相关知识,感兴趣的朋友可以了解下
    2021-01-01
  • Vue.js实例方法之生命周期详解

    Vue.js实例方法之生命周期详解

    这篇文章主要给大家介绍了关于Vue.js实例方法之生命周期的相关资料,文中通过示例代码介绍的非常详细,对大家具有一定的参考学习价值,需要的朋友们下面跟着小编一起来学习学习吧。
    2017-07-07
  • Vue官网todoMVC示例代码

    Vue官网todoMVC示例代码

    本篇文章主要介绍了Vue官网todoMVC示例代码,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-01-01
  • 基于vue中css预加载使用sass的配置方式详解

    基于vue中css预加载使用sass的配置方式详解

    下面小编就为大家分享一篇基于vue中css预加载使用sass的配置方式详解,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-03-03
  • Vue.js设计与实现无限递归学习总结

    Vue.js设计与实现无限递归学习总结

    这篇文章主要为大家介绍了Vue.js设计与实现无限递归学习总结,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-05-05
  • nuxt框架中路由鉴权之Koa和Session的用法

    nuxt框架中路由鉴权之Koa和Session的用法

    后台管理页面需要有登录系统,所以考虑做一下路由鉴权,这篇文章主要介绍了nuxt框架中路由鉴权之Koa和Session的用法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-05-05
  • 使用Vue3和Plotly.js绘制动态3D图表的示例代码

    使用Vue3和Plotly.js绘制动态3D图表的示例代码

    在数据可视化应用中,需要将数据动态加载到图表中并进行实时更新,本文将展示如何使用Plotly.js和Vue.js实现这一功能,从加载外部数据到创建交互式图表,文中有相关的代码示例供大家参考,需要的朋友可以参考下
    2024-06-06
  • Vue实现简易购物车页面

    Vue实现简易购物车页面

    这篇文章主要为大家详细介绍了Vue实现简易购物车页面,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-12-12

最新评论