vue+ElementUI 表单嵌套表格逐行校验(新增、编辑)的完美解决方案

vue+ElementUI 表单嵌套表格逐行校验(新增、编辑)的完美解决方案

一、成果

在线地址

gitHub地址

如果帮到你,请点个赞^_^
在这里插入图片描述

如图,ElementUI表单里嵌套了表格,表格内每行能进行新增、编辑、删除等操作,同时能针对该行的字段进行校验(而不是整个表单校验!),这种需求应该很常见,但是搜了很多资料,没有完美的解决方案,大部分都只是针对整个表单进行校验,而不是一行里面的字段校验,所以困扰了很久,最近终于研究了完美解决方案,分享给大家。




二、要点和解决思路

  1. 表格数据datas必须是某对象(以form为例)的一个属性

      form: {
        datas: [
          { id: 1, name: "张三", age:20 },
          { id: 2, name: "李四", age:32 },
        ],
      },
    
  2. 每个字段要动态绑定表单的prop属性(以name字段为例)

    <el-form :model="form" :rules="rules" ref="form">
    	.....
       <el-form-item :prop="'datas.'+scope.$index + '.name'" :rules='rules.name'>
    </el-form>
    

    关键代码:prop="'datas.'+scope.$index + '.name'",这是elementui规定的格式,渲染后的结果为’datas.1.name’。所以必须结合第1点才能实现,否则提示出错!(这里坑了我很长时间)

  3. 每个字段要动态绑定表单的rules属性
    <el-form-item :prop="‘datas.’+scope.$index + ‘.name’" :rules='rules.name'>

  4. 针对某一行的所有字段进行校验
    通过控制台查看得知:表单的字段对象存在this.$refs[‘form’].fields里面,并且字段对象具有prop属性(’datas.1.name’)和validateField方法(验证’datas.1.name’能否通过校验)。

    那么我们创建一个函数validateField,来判断第index行的所有字段能否通过校验:

      //对部分表单字段进行校验
      validateField(form,index){
        let result = true;
        for (let item of this.$refs[form].fields) {
          if(item.prop.split(".")[1] == index){
            this.$refs[form].validateField(item.prop,(error)=>{
              if(error!=""){
                result = false;
              }
            });
          }
          if(!result) break;
        }
        return result;
      },
    
  5. 针对某一行的所有字段进行重置操作
    同理,表单的字段对象存在resetField方法来重置数据,那么我们创建一个函数 resetField,来重置第index行的所有字段

      //对部分表单字段进行重置
      resetField(form,index){
        this.$refs[form].fields.forEach(item=>{
          if(item.prop.split(".")[1] == index){
            item.resetField();
          }
        })
      },
    
  6. 每一行的状态可以通过添加属性action来处理
    数据初始化的时候,每一行对象添加action属性(‘view’:查看状态,'edit’编辑状态,'add’新增状态)

      created() {
         //处理数据,为已有数据添加action:'view'
         this.form.datas.map(item => {
           this.$set(item,"action","view")
           return item;
         });
    
         //再插入一条添加操作的数据
         this.form.datas.unshift({
           id:undefined,
           name:undefined,
           age:undefined,
           action: "add"
         });
       },
    



三、源码

<template>
  <div id="app">
    <el-form :model="form" :rules="rules" ref="form">
      <el-table :data="form.datas" highlight-current-row style="width: 100%">
        <el-table-column prop="id" label="序号" width="60"></el-table-column>

        <el-table-column prop="name" label="姓名">
          <template slot-scope="scope">
            <template v-if="scope.row.action == 'view'">
              {{scope.row.name}}
            </template>
            <template v-else>
              <el-form-item :prop="'datas.'+scope.$index + '.name'" :rules='rules.name'>
                <el-input size="mini" v-model.trim="scope.row.name" style="width: 120px;"></el-input>
              </el-form-item>
            </template>
          </template>
        </el-table-column>
        
        <el-table-column prop="name" label="年龄">
          <template slot-scope="scope">
            <template v-if="scope.row.action == 'view'">
              {{scope.row.age}}
            </template>
            <template v-else>
              <el-form-item :prop="'datas.'+scope.$index + '.age'" :rules='rules.age'>
                <el-input size="mini" v-model.number="scope.row.age" style="width: 60px;"></el-input>
              </el-form-item>
            </template>
          </template>
        </el-table-column>

        <el-table-column prop="operation" label="操作">
          <template slot-scope="scope">
            <template v-if="scope.row.action == 'view'">
              <el-button size="mini" @click="click_edit(scope.row, scope.$index)">编辑</el-button>
              <el-button size="mini" @click="click_delete(scope.row, scope.$index)">删除</el-button>
            </template>
            <template v-else-if="scope.row.action == 'add'">
              <el-button size="mini" @click="click_add( scope.row, scope.$index)">新增</el-button>
              <el-button size="mini" @click="click_reset(scope.row, scope.$index)">重置</el-button>
            </template>
            <template v-else>
              <el-button size="mini" @click="click_save(scope.row, scope.$index)">保存</el-button>
              <el-button size="mini" @click="click_cancle(scope.row, scope.$index)">取消</el-button>
            </template>
          </template>
        </el-table-column>
      </el-table>
    </el-form>
  </div>
</template>
<script>



</script>
<script>
  export default {
    data() {
      return {
        form: {
          datas: [
            { id: 1, name: "张三", age:20 },
            { id: 2, name: "李四", age:32 },
          ],
        },

        //表单验证规则
        rules: {
          name: [{
            type: 'string',
            required: true,
            trigger: 'blur',
            message: '请输入姓名',
          }],
          age: [{
            type: 'number',
            required: true,
            trigger: 'blur',
            message: '请输入年龄',
          },
          {
            type: 'number',
            trigger: 'blur',
            min: 0,
            max: 120,
            message: '年龄最小0,最大120',
          }],
        }
      }
    },

    created() {
      //处理数据,为已有数据添加action:'view'
      this.form.datas.map(item => {
        this.$set(item,"action","view")
        return item;
      });

      //再插入一条添加操作的数据
      this.form.datas.unshift({
        id:undefined,
        name:undefined,
        age:undefined,
        action: "add"
      });
    },

    methods: {
      //对部分表单字段进行校验
      validateField(form,index){
        let result = true;
        for (let item of this.$refs[form].fields) {
          if(item.prop.split(".")[1] == index){
            this.$refs[form].validateField(item.prop,(error)=>{
              if(error!=""){
                result = false;
              }
            });
          }
          if(!result) break;
        }
        return result;
      },
      
      //对部分表单字段进行重置
      resetField(form,index){
        this.$refs[form].fields.forEach(item=>{
          if(item.prop.split(".")[1] == index){
            item.resetField();
          }
        })
      },
      
      //新增操作
      click_add(item,index) {
        if( !this.validateField('form',index) ) return;
        //模拟新增一条数据
        let itemClone = JSON.parse(JSON.stringify(item));
        itemClone.id = this.form.datas.length;
        itemClone.action = "view";
        this.form.datas.push(itemClone);
        this.resetField('form',index);
      },
      
      //新增-重置操作
      click_reset(item,index) {
        this.resetField('form',index);
      },
      
      //编辑-保存操作
      click_save(item,index) {
        if( !this.validateField('form',index) ) return;
        item.action = "view";
      },
      
      //编辑-取消操作
      click_cancle(item,index) {
        this.resetField('form',index);
        item.action = "view";
      },
      
      //编辑操作
      click_edit(item,index) {
        item.action = "edit";
      },

      //删除操作
      click_delete(item,index) {
        this.$confirm("确定删除该条数据(ID" + item.id + ")吗?", "提示", {
            confirmButtonText: "确定",
            cancelButtonText: "取消",
            type: "warning"
          })
          .then(() => {
            //模拟删除一条数据
            this.form.datas.splice(index,1);
          })
          .catch(() => {});
      },

    },
  }
</script>


<style>
  .el-table .cell{
    overflow: visible;
  }
  .el-form-item{
    margin-bottom: 0;
  }
  .el-form-item__error{
    padding-top:0;
    margin-top:-3px;
  }
</style>

如果帮到你,点个赞再走

### Vue3 和 Element Plus 中实现数字输入框校验的方式 在 Vue3 和 Element Plus 的开发环境中,可以通过多种方法来实现对 `el-input` 输入框的数字校验功能。以下是几种常见的实现方式: #### 方法一:通过正则表达式限制输入内容 可以利用事件监听器(如 `@input` 或者 `@blur`),结合 JavaScript 正则表达式过滤掉不符合条件的内容。 对于仅允许输入数字的情况: ```html <el-input v-model="numberInput" placeholder="请输入纯数字" @input="numberInput = numberInput.replace(/[^\d]/g, '')" /> ``` 上述代码会实时拦截并移除任何非数字字符[^1]。 如果需要支持带小数点的数值,则可调整正则表达式如下: ```html <el-input v-model="decimalInput" placeholder="请输入数字和小数点" @input="decimalInput = decimalInput.replace(/[^0-9.]/g, '')" /> ``` #### 方法二:基于表单验证规则 Element Plus 提供了一套完整的表单校验机制,能够更灵活地定义复杂的校验逻辑。下面是一个简单的例子展示如何设置针对数字类型的校验规则。 首先,在脚本部分定义好相应的校验规则对象: ```javascript const rules = { age: [ { required: true, message: '年龄不能为空', trigger: ['blur', 'change'] }, { type: 'number', min: 0, max: 150, message: '请输入有效的年龄范围(0~150)', trigger: ['blur', 'change'] } ] }; ``` 接着绑定这些规则至具体的 `<el-form-item>` 上面去应用它们。 ```html <el-form :model="form" :rules="rules" ref="formRef"> <el-form-item prop="age" label="Age"> <el-input-number v-model.number="form.age"></el-input-number> </el-form-item> </el-form> ``` 注意这里使用到了 `.number` 修改器确保模型数据被强制转换成 Number 类型以便于后续处理[^4]。 另外还可以自定义更加复杂或者特定场景下的校验函数满足特殊需求比如限定整数还是浮点数等等[^3]。 #### 方法三:动态多级嵌套结构中的字段校验 当面对较为复杂的业务形态时,例如存在多个子项组成的列表形式的数据源,并且每一个条目都需要单独完成各自的属性检验工作的话,那么就需要采用类似于引用材料所提到的技术方案——即借助字符串模板拼接出精确指向目标路径的名字作为对应控件关联起来使用的 property 属性值[^2]。 --- ### 示例代码片段 以下是一份综合以上三种技术要点的实际操作案例演示: ```vue <script setup lang="ts"> import { reactive, ref } from 'vue'; import type { FormInstance } from 'element-plus'; interface FormData { formList: Array<{ table: Array<{ orderSn?: string }> }>; } const formRef = ref<FormInstance>(); const formData = reactive<FormData>({ formList: [{ table: [] }] }); // 初始化一些假定初始状态... for(let i=0;i<5;i++) formData.formList.push({table:[{},{orderSn:""}]}); function validateOrderSn(rule:any,value:string,callback:(error?:Error)=>void){ if(!/^[+-]?(\d+(\.\d*)?|\.\d+)$/.test(value)){ return callback(new Error('订单编号应为合法实数')); } callback(); } const tableRules={ orderSn:[ {validator:validateOrderSn,trigger:['blur','change']} ] }; async function submitForm(){ try{ await formRef.value?.validate((valid:boolean)=>{ console.log(valid?'提交成功':'仍有错误'); }); }catch(e){console.error(e);} } </script> <template> <el-form :model="formData" ref="formRef" label-width="80px"> <div v-for="(item,idx) in formData.formList" :key="'list'+idx"> <!-- 嵌套循环渲染内部表格 --> <el-container style="margin-bottom:.5em;"> 表格{{ idx }} <ul> <li v-for="(row,$index) in item.table" :key="$index"> 编号{{$index}}:<el-form-item :prop="`formList.${idx}.table.${$index}.orderSn`" :rules="tableRules.orderSn"> <el-input v-model="row.orderSn"/> </el-form-item> </li> </ul> </el-container> </div> <button @click.prevent="submitForm">Submit</button> </el-form> </template> ``` ---
评论 29
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值