Vue2+ElementUI表单、Form组件的封装过程

更新时间：2024年03月13日 11:05:16 作者：記億揺晃着的那天

在 Vue2 项目中,ElementUI 的 el-form 组件是常用的表单组件,它提供了丰富的功能和样式,可以满足各种需求,本文给大家介绍Vue2+ElementUI表单、Form组件的封装过程,感兴趣的朋友跟随小编一起看看吧

Vue2+ElementUI表单、Form组件的封装：引言

在 Vue2 项目中，ElementUI 的 el-form 组件是常用的表单组件。它提供了丰富的功能和样式，可以满足各种需求。但是，在实际开发中，我们经常会遇到一些重复性的需求，比如：

需要对表单进行校验
需要对表单数据进行重置
需要在表单中添加额外的功能，比如动态添加表单项等

为了提高开发效率，我们可以对 el-form 组件进行封装，将这些重复性的需求抽象成通用的功能。这样，在后续的项目中，我们就可以直接使用封装好的组件，而无需重复开发。

预期效果

预期效果如下。

创建表单组件

先把架子搭起来,组件名为H3yunFormCompV1,这个是随便取的哈。然后随便在哪个地方用上，方便测试。

<template>
  <div>
    <el-form>
    </el-form>
  </div>
</template>
<script>
export default {
  name: "H3yunFormCompV1",
  data() {
    return {}
  },
  props: {},
  mounted() {
  },
  methods: {}
}
</script>
<style scoped>
</style>

父组件传递表单数据，子组件遍历数据

把formData数据传递过去。formData是一个列表，每个对象的结果如下{label: null, value: null}非常的简单。

 <H3yunFormCompV1 :formData="formData"></H3yunFormCompV1>
data() {
    return {
formData: []
}
}

子组件如下：使用v-for遍历formData，并把label和value取出来。

<template>
  <div>
    <el-form ref="form" :model="form" :inline="true">
      <el-form-item v-for="(item,key) in formData" :key="key" :label="item.label">
        <el-input v-model="item.value"></el-input>
      </el-form-item>
    </el-form>
  </div>
</template>
<script>
export default {
  name: "H3yunFormCompV1",
  data() {
    return {
      form: {
        name: '',
        region: '',
        date1: '',
        date2: '',
        delivery: false,
        type: [],
        resource: '',
        desc: ''
      }
    }
  },
  props: {
    formData: Array
  },
  mounted() {
  },
  methods: {}
}
</script>
<style scoped>
</style>

添加disabled属性

子组件的完整代码

<template>
  <div>
    <el-row>
      <el-form
          ref="form"
          :model="form"
          label-position="top"
          size="small"
      >
        <el-col :span="6" v-for="(item,key) in formData" :key="key">
          <div class="box">
            <el-form-item :label="item.label">
              <el-input v-model="item.value" :disabled="item.disabled"></el-input>
            </el-form-item>
          </div>
        </el-col>
      </el-form>
    </el-row>
  </div>
</template>
<script>
export default {
  name: "H3yunFormCompV1",
  data() {
    return {
      form: {
        name: '',
        region: '',
        date1: '',
        date2: '',
        delivery: false,
        type: [],
        resource: '',
        desc: ''
      }
    }
  },
  props: {
    formData: Array
  },
  mounted() {
  },
  methods: {}
}
</script>
<style>
.box {
  font-size: 14px;
  padding: 6px 12px;
  color: #304265;
  background: #f8fafc;
  border-radius: 4px;
  min-height: 22px;
  box-sizing: content-box;
  font-family: PingFangSC-Regular, PingFang SC;
  font-weight: 400;
}
.box .el-form-item__label {
  position: relative;
  font-size: 14px;
  font-family: PingFangSC-Regular, PingFang SC;
  font-weight: 400;
  color: #304265;
  font-weight: 400 !important;
}
</style>

效果如下：

适配JSON数据

先看效果，下面是销量预测的json数据。

代码如下：主要是把json数据解析为了一个个表单项。

<template>
  <div>
    <el-row>
      <el-form
          ref="form"
          :model="form"
          label-position="top"
          size="small"
      >
        <el-col :span="6" v-for="(item,key) in formStructure" :key="key">
          <div class="box">
            <el-form-item :label="item.label">
              <el-input v-model="item.value" :disabled="item.disabled"></el-input>
            </el-form-item>
          </div>
        </el-col>
      </el-form>
    </el-row>
  </div>
</template>
<script>
export default {
  name: "H3yunFormCompV1",
  data() {
    return {
      form: {},
      formStructure: []
    }
  },
  props: {
    formData: Array
  },
  watch: {
    // 监控父组件的表单数据
    formData: {
      handler(newFormData) {
        // 当 formData 变化时执行的操作
        // 解析新表单结构
        this.parseFormStructure(newFormData);
      },
      deep: true, // 深度监听，用于监听数组或对象内部的变化
    },
  },
  mounted() {
    // 解析新表单结构 - 第一次点击时执行
    this.parseFormStructure()
  },
  methods: {
    // 解析表单结构
    parseFormStructure() {
      // 清除表单结构和表单数据
      this.formStructure = []
      this.form = {}
      const formStructure = []
      // column的数据类型：{ label: null, value: null, prop: null, disabled: null, dataType: null}
      this.formData.forEach(column => {
        if (column.dataType == undefined) {
          column.dataType = 'text'
        }
        // 如果数据是json,需要把JSON数据装为column的结构
        if (column.dataType == 'json') {
          const label = column.label
          const prop = column.prop
          const jsonValue = column.value
          const disabled = column.disabled
          const jsonObj = JSON.parse(jsonValue)
          // 构建column对象
          Object.keys(jsonObj).forEach(key => {
            const childLabel = `${label}.${key}`
            const childProp = `${prop}.${key}`
            const childValue = jsonObj[key]
            const childDisabled = disabled
            const childColumn = {
              label: childLabel,
              value: childValue,
              prop: childProp,
              disabled: childDisabled,
              dataType: 'text'
            }
            formStructure.push(childColumn)
          })
        } else {
          formStructure.push(column)
        }
      })
      this.formStructure = formStructure
    }
  }
}
</script>
<style>
.box {
  font-size: 14px;
  padding: 6px 12px;
  color: #304265;
  background: #f8fafc;
  border-radius: 4px;
  min-height: 22px;
  box-sizing: content-box;
  font-family: PingFangSC-Regular, PingFang SC;
  font-weight: 400;
}
.box .el-form-item__label {
  position: relative;
  font-size: 14px;
  font-family: PingFangSC-Regular, PingFang SC;
  font-weight: 400;
  color: #304265;
  font-weight: 400 !important;
}
</style>

表单提交

首先写个提交按钮，并添加个change表单提交事件。

 <el-button type="primary" size="small" @change="submitForm">提交</el-button>

提交逻辑如下

// 提交的数据在this.form里面，表单验证通过后可以使用axios把表单数据提交到服务器。
submitForm() {
      // 使用 this.$refs.form.validate() 进行表单验证
      this.$refs.form.validate((valid) => {
        if (valid) {
          // 表单验证通过，执行提交操作
          // 在这里你可以使用 Axios 或其他方式提交数据到后端
          // 示例：假设有一个名为 submitData 的方法用于提交数据
          this.submitData();
        } else {
          // 表单验证失败，可以做一些处理，如提示用户
          this.$message.error('表单验证失败，请检查输入信息。');
        }
      });
    },
    submitData() {
      // 在这里执行提交数据的操作
      // 可以使用 Axios 或其他方式发送数据到后端
      // 示例：假设有一个名为 postData 的方法用于发送数据
      // postData(this.form)
      this.$message.success('表单提交成功！');
    }

到此这篇关于Vue2+ElementUI表单、Form组件的封装的文章就介绍到这了,更多相关Vue2 ElementUI表单内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

vue实现全选功能
这篇文章主要为大家详细介绍了vue实现全选功能，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-10-10
vue-cli3脚手架安装方法
这篇文章主要介绍了vue-cli3脚手架安装方法，本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
2023-04-04
el-select自定义指令实现触底加载分页请求options数据(完整代码和接口可直接用)
某些情况下,下拉框需要做触底加载,发请求,获取option的数据,下面给大家分享el-select自定义指令实现触底加载分页请求options数据(附上完整代码和接口可直接用),感兴趣的朋友参考下吧
2024-02-02
Vue使用extend动态创建组件的实现
本文主要介绍了Vue使用extend动态创建组件的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-04-04
vue中ref的用法小结
在项目中使用ref时有时候直接取值,有时候返回的却是一个数组,不知其中缘由,后查了一下ref用法,在这里给大家分享vue中ref的用法,感兴趣的朋友一起看看吧
2023-11-11
vue项目打包后,由于html被缓存导致出现白屏的处理方案
这篇文章主要介绍了vue项目打包后,由于html被缓存导致出现白屏的处理方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-03-03
Vue vxe-table使用问题收录小结
这篇文章主要为大家介绍了Vue vxe-table使用问题收录小结,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
2023-09-09
分享一个vue项目“脚手架”项目的实现步骤
这篇文章主要介绍了分享一个vue项目“脚手架”项目的实现步骤，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2019-05-05
Vue实例中el和data的两种写法小结
这篇文章主要介绍了Vue实例中el和data的两种写法,本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2023-11-11
vuecli+AXdownload下载组件封装 +css3下载悬浮球动画效果
当触发下载功能的时候,会触发一个下载动画,下载悬浮球会自动弹出,并且闪烁提示有新的下载任务直到下载任务完场提示,接下来通过本文介绍vuecli+AXdownload下载组件封装 +css3下载悬浮球动画效果,需要的朋友可以参考下
2024-05-05