Element Plus Form 动态表单自定义校验规则使用教程

最新推荐文章于 2025-04-03 19:41:00 发布

原创

最新推荐文章于 2025-04-03 19:41:00 发布 · 1w 阅读

18 ·

CC 4.0 BY-SA版权

文章标签：

#vue.js #elementui #javascript #view design

本文围绕Element Plus展开，它是基于Vue 3的组件库。官网动态表单示例规则固定，文章讲解了动态表单自定义规则的使用，包括表单自定义规则、单字段和多字段动态表单自定义规则，最后总结将官网rules对象改成数组添加规则，此方式也适用于View UI Plus。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Element Plus，基于 Vue 3，面向设计师和开发者的组件库

Element Plus 官网：https://element-plus.org/zh-CN/

Element Plus Form 动态表单自定义效验规则，官网示例代码中没有，官网示例中的动态表单是固定的规则，本文讲解动态表单自定义规则的使用

1、官网动态表单示例代码

先看官网动态表单示例代码

<template>
  <el-form
    ref="formRef"
    :model="dynamicValidateForm"
    label-width="120px"
    class="demo-dynamic"
  >
    <el-form-item
      prop="email"
      label="Email"
      :rules="[
        {
          required: true,
          message: 'Please input email address',
          trigger: 'blur',
        },
        {
          type: 'email',
          message: 'Please input correct email address',
          trigger: ['blur', 'change'],
        },
      ]"
    >
      <el-input v-model="dynamicValidateForm.email" />
    </el-form-item>
    
    <el-form-item
      v-for="(domain, index) in dynamicValidateForm.domains"
      :key="domain.key"
      :label="'Domain' + index"
      :prop="'domains.' + index + '.value'"
      :rules="{
        required: true,
        message: 'domain can not be null',
        trigger: 'blur',
      }"
    >
      <el-input v-model="domain.value" />
      <el-button class="mt-2" @click.prevent="removeDomain(domain)"
        >Delete</el-button
      >
    </el-form-item>
    <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>
</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: '',
    },
  ],
  email: '',
})

interface DomainItem {
  key: number
  value: 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: '',
  })
}

const submitForm = (formEl: FormInstance | undefined) => {
  if (!formEl) return
  formEl.validate((valid) => {
    if (valid) {
      console.log('submit!')
    } else {
      console.log('error submit!')
      return false
    }
  })
}

const resetForm = (formEl: FormInstance | undefined) => {
  if (!formEl) return
  formEl.resetFields()
}
</script>

运行效果

这个是把 rules 写死在 el-form-item 标签上的

2、表单自定义规则

官网的自定义规则是在 el-form 标签上添加 rules 属性，并在 rules 属性中定义自定义规则，el-form-item 标签通过 prop 属性对应找到规则

官网示例代码

<template>
  <el-form
    ref="ruleFormRef"
    :model="ruleForm"
    status-icon
    :rules="rules"
    label-width="120px"
    class="demo-ruleForm"
  >
    <el-form-item label="Pass