el-form的rules如何校验多层嵌套对象

本文详细讲解了如何在Element UI的el-form中进行复杂嵌套数据的校验,包括如何处理多层级的对象和数组,以及不同场景下的校验规则编写和注意事项。

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

el-form的表单校验,通常情况下,都是在校验第一层对象时使用

例如:

<el-form ref="form" :model="postData" :rules="rules" class="common-form" label-width="118px" size="mini">
   <el-row>
     <el-col :span="12">
       <el-form-item prop="custType" label="客户属性">
         <el-radio-group v-model="postData.custType" @change="changeCustomerType">
           <el-radio label="客户属性1">客户属性1</el-radio>
           <el-radio label="客户属性2">客户属性2</el-radio>
         </el-radio-group>
       </el-form-item>
     </el-col>
     <el-col :span="12">
       <el-form-item label="客户名称" class="hintparent" prop="custId">
         <el-select
           v-model="postData.custId"
           placeholder="请选择"
         >
           <el-option
             v-for="item in customers"
             :key="item.id"
             :label="item.cname"
             :value="item.id"
           ></el-option>
         </el-select>
       </el-form-item>
     </el-col>
  <el-row>
</el-form>

数据结构为:

postData: {
  custType: '',
  custId: '',
},

校验规则为

rules: {
  custType: [{ required: true, message: '请选择客户属性', trigger: 'change' }],
  custId: [{ required: true, message: '请选择客户名称', trigger: 'change' }]
}

注意到 prop里的名称和属性名和rules里的检验字段名需保持一致。

现有一段数据结构如下:

postData: {
	stamp: {
       person: null,
       tel: null,
       reason: null
    }
}

当数据嵌套到两层时,校验第二层的数据时,可以这么做

<el-form-item
	 prop="stamp.concatPerson"
	 label="联系人"
	 :rules="{ required: postData.stamp.needPost === 0, message: '请填写联系人', trigger: 'change' }"
	>
	 <el-input v-model="postData.stamp.concatPerson"></el-input>
</el-form-item>
<el-form-item
	 v-if="postData.stamp.needPost === 0"
	 prop="stamp.tel"
	 label="联系电话"
	 class="hintparent"
	 :rules="[
	   { required: postData.stamp.needPost === 0, message: '请填写联系电话', trigger: 'change' },
	   {
	     pattern: /^[\d\-]+$/,
	     message: '电话格式不正确',
	     trigger: 'change'
	   },
	   { max: 20, message: '电话格式不正确', trigger: 'change' }
	 ]"
	>
	 <el-input v-model="postData.stamp.tel"></el-input>
</el-form-item>
<el-form-item prop="stamp.reason" label="盖章原因" class="hintparent">
	 <el-input
	   v-model="postData.stamp.reason"
	   maxlength="2000"
	   show-word-limit
	   type="textarea"
	   :autosize="{ minRows: 4 }"
	   :rules="[
	     { required: true, message: '请填写盖章原因', trigger: 'change' },
	     { max: 2000, message: '最多只能输入2000个字', trigger: 'change' }
	   ]"
	 ></el-input>
</el-form-item>

此时props传的是去掉最外层之后的嵌套对象,rules写在组件内部,没有拎出来的原因是因为我需要判断required的值,而在data()里获取不到this会报错。
在不需要做我这种判断时,也可以拎出来,写法如下

//第一种方式
stamp: {
	 reason: [
	    { required: true, message: '请填写盖章原因', trigger: 'change' },
	    { max: 2000, message: '最多只能输入2000个字', trigger: 'change' }
	  ]
}
//第二种方式
'stamp.reason': [
	  { required: true, message: '请填写盖章原因', trigger: 'change' },
	  { max: 2000, message: '最多只能输入2000个字', trigger: 'change' }
]

两种方式差不多,第二种比较简洁,第一种在嵌套对象比较多时可读性更高
开发中需要注意的是,需要初始化嵌套层级多的数据的n-1层,不然会报错哦,比如这里就需要初始化:postData.stamp: {},
如果是postData.stamp.my.reason,就需要初始化到postData.stamp.my: {}

如果想校验数组内的数据呢

那就只能把校验逻辑写在标签上了

<el-form
      ref="form"
      :model="formData"
      class="common-form"
      :label-width="$i18n.locale === 'US' ? '200px' : '145px'"
      size="mini"
    >
	<div v-for="(item, index) in formData.arr" :key="index">
		<el-form-item
          :label="单号"
           class="hintparent"
           prop="seq"
           :rules="{
             required: true,
             message: '请输入单号',
             validator: (rule, value, callback) => validData(rule, item.seq, callback)
           }"
         >
         </el-form-item>
         <el-form-item
           :label="金额"
           class="hintparent"
           prop="amount"
           :rules="{
             required: true,
             message: '请输入金额',
             validator: (rule, value, callback) => validData(rule, item.amount, callback)
           }"
         >
         </el-form-item>
	</div>
</el-form>

<script>
	data() {
		return {
			formData: {
				arr: []
			}
		}
	},
	methods: {
		validData(rule, value, callback) {
	      if (rule.required && !value) {
	        callback(new Error(rule.message));
	      } else {
	        callback();
	      }
    	}
	}
</script>
### 绑定多层对象至 `el-form` 当处理复杂的表单结构时,`el-form` 需要能够绑定到具有多层嵌套对象上。为了确保这种复杂结构能被正确识别并更新,在 Vue 中使用响应式特性是非常重要的。 对于多层嵌套对象的场景,推荐采用 `reactive()` 来创建组件的状态管理器,这可以保证即使是最深层级的数据变化也能触发视图更新[^3]。下面是一个具体的例子来展示如何实现这一点: ```html <template> <div> <!-- 表单整体配置 --> <el-form :model="formState" ref="ruleFormRef" :rules="rules" label-width="160px"> <!-- 定义表单项 --> <el-form-item label="详细地址" prop="location.placeText"> <el-input placeholder="请输入详细地址" v-model="formState.location.placeText"></el-input> </el-form-item> <!-- 更多功能项可按需添加... --> </el-form> </div> </template> <script setup lang="ts"> import { reactive, ref } from 'vue'; // 假设这是你的初始数据状态 const formState = reactive({ location: { placeText: '' } }); // 这里定义了用于验证输入框内容合法性的规则集 const rules = { 'location.placeText': [ { required: true, message: '请填写详细地址', trigger: 'blur' }, ] }; // 创建一个ref实例用来获取dom节点 const ruleFormRef = ref(null); /* ...其他逻辑代码 */ </script> ``` 在这个案例中,通过将 `formState` 设为反应式的变量,并将其作为模型传递给 `<el-form>` 的 `:model` 属性,实现了对深层次属性的有效监听与同步显示。同时注意到了 `prop` 参数应该指向完整的路径名以便于校验功能正常工作[^2]。 #### 关键点总结 - 使用 `reactive()` 构建顶层 state 对象以支持深层次的数据绑定。 - 确保所有的子属性都已经被初始化;未初始化的情况下可能会导致某些情况下无法正确渲染或更新。 - 当设置 `el-form-item` 的 `prop` 属性时,请提供完整的路径字符串表示法(例如 `"location.placeText"`),这样可以让框架知道具体哪个字段需要关联起来做验证操作。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值