vue封裝form表單組件拒絕重復寫form表單

Posted on 2022-07-29 by WalkonNet

前言

在日常工作中，當需要處理的form表單很多時,我們沒有必要一遍又一遍地重復寫form表單，直接封裝一個組件去處理就好。其實很早之前就有涉獵通過使用類似配置json方法寫form表單的文章，雖然當時也沒怎麼認真看…我們前端組也是使用這種思想配置的。

然而，這個思想和方法很早就有出現過，並不怎麼新穎，還望不喜勿噴…在此我封裝瞭一個最最最基礎的form表單，離我們前端組封裝的組件差距還很大，有興趣朋友們的可以繼續往下完善。

核心思想：

通過配置js文件的變量，使用vue的is屬性動態切換組件，默認顯示的組件為el-input
通過element的分欄和柵格屬性，對form表單進行響應式佈局
baseForm在組件初始化時，需要動態添加校驗規則、請求接口以及初始化form的部分值
正統思想是對element組件的各個組件進行二次封裝，然後通過is屬性切換二次封裝後的組件，在此不做過多描述，有興趣的朋友可以自行研究
更好的思想是將頁面請求、搜索項、表格、分頁封裝到一起，形成一個整體，這也是我們前端小組目前的處理思路

實現重點：

任何標簽或者組件都可以通過vue的is屬性來動態切換組件。本組件中使用div，將它的寬度設置為100%，使得element組件能夠完全撐開。(使用vue內置組件component會與el-radio-group相沖突，因為它底層就是用component實現的)
表單上添加validate-on-rule-change="false"屬性，防止在表單初始化時就校驗表單
當為對象添加不存在的字段屬性時，需要使用$set實現數據的響應式
如果form表單中隻有一個輸入框，在輸入框中按下回車會提交表單，刷新頁面。為瞭阻止這一默認行為，需要在el-form標簽上添加@submit.native.prevent
使用lodash中的get方法獲取對象的屬性值，如果屬性值不存在，可以給一個默認值
baseForm子組件中可以傳一個form對象給父組件，那麼添加或者編輯form對象，就都可以在父組件中進行。

表單雙向綁定的方式有兩種:

1.使用v-model進行雙向綁定

<div
  v-else
  clearable
  style="width: 100%"
  type="daterange"
  range-separator="至"
  start-placeholder="開始日期"
  end-placeholder="結束日期"
  v-model="form[column.prop]"
  :label-width="get(column, 'size', column || defaultFormSize)"
  :disabled="get(column, 'disabled', false)"
  :is="get(column, 'type', 'el-input')"
>

2.使用v-model的語法糖

(`:value以及@input`)進行雙向綁定

<div
  v-else
  clearable
  style="width: 100%"
  type="daterange"
  range-separator="至"
  start-placeholder="開始日期"
  end-placeholder="結束日期"
  :value="form[column.prop]"
  :label-width="get(column, 'size', column || defaultFormSize)"
  :disabled="get(column, 'disabled', false)"
  :is="get(column, 'type', 'el-input')"
  @input="input($event,column.prop)"
>
methods: {
    input(e,prop) {
      this.$set(this.form, prop, e)
    }
}

配置項

(本組件寫得比較基礎，目前僅支持element的五個常用組件)：

整體字段：

formSize (表單中各element組件的整體大小)

column數組中每一個對象對應的字段(非請求接口)：

label (表單label的名稱)
span (這個表單項占據的份數，一行為24，默認為12)
labelWidth (這個表單項的label寬度，默認為90px)
labelHeight (這個表單項占據的高度，默認為50px)
slotName (插槽名)
prop (這個表單項綁定的屬性名稱)
size (這個表單項組件的大小，默認為small)
disabled (是否禁用這個表單項)
type (使用的element組件，默認為el-input)
dic (非接口請求的靜態表單數據,使用{label以及value字段}表示的數組形式)

column數組中每一個對象對應的字段(請求接口)：

url (接口的api地址)
requestParams (非必填項，需要額外傳入的傳參)
requestLabel (接口返回對應的id)
requestValue (接口返回對應的value)

效果瀏覽

源碼放送

1. baseForm組件

<template>
  <el-form
    ref="form"
    :model="form"
    :rules="formRules"
    :size="get(option, 'formSize', defaultFormSize)"
    :validate-on-rule-change="false"
    @submit.native.prevent
  >
    <el-row :gutter="20" :span="24">
      <el-col 
        v-for="column in formColumn" 
        :key="column.label" 
        :md="column.span || 12" 
        :sm="12" 
        :xs="24"
      >
        <el-form-item
          :label="`${column.label}:`"
          :prop="column.prop"
          :label-width="get(column, 'labelWidth', column.labelWidth || defaultLabelWidth)"
          :style="{
            height: get(column, 'labelHeight', column.labelHeight || defaultLabelHeight)
          }"
        >
          <slot
            v-if="column.slotName"
            :name="column.slotName"
            :form="form"
            :prop="column.prop"
            :value="form[column.prop]"
          ></slot>
          <div
            v-else
            clearable
            style="width: 100%"
            type="daterange"
            range-separator="-"
            start-placeholder="開始日期"
            end-placeholder="結束日期"
            v-model="form[column.prop]"
            :placeholder="getPlaceholder(column.type, column.label)"
            :label-width="get(column, 'size', column || defaultFormSize)"
            :disabled="get(column, 'disabled', false)"
            :is="get(column, 'type', 'el-input')"
          >
            <template v-if="column.type == 'el-select'">
              <el-option 
                v-for="item in column.dic" 
                :key="item.value" 
                :label="item.label" 
                :value="item.value"
              >
              </el-option>
            </template>
            <template v-if="column.type == 'el-radio-group'">
              <el-radio 
                v-for="item in column.dic" 
                :key="item.value" 
                :label="item.label"
              >
                {{ item.value }}
              </el-radio>
            </template>
            <template v-if="column.type == 'el-checkbox-group'">
              <el-checkbox 
                v-for="item in column.dic" 
                :key="item.label" 
                :label="item.value"
              >
                {{ item.label }}
              </el-checkbox>
            </template>
          </div>
        </el-form-item>
      </el-col>
    </el-row>
  </el-form>
</template>
<script>
import get from 'lodash/get'
import request from '@/service/request'
export default {
  props: {
    option: {
      type: Object,
      default: () => {}
    },
    form: {
      type: Object,
      default: () => {}
    }
  },
  data() {
    return {
      formRules: {},
      defaultFormSize: 'small',
      defaultLabelWidth: '90px',
      defaultLabelHeight: '50px'
    }
  },
  computed: {
    formColumn() {
      return this.option.column
    }
  },
  created() {
    this.initRules()
    this.initRequest()
    this.initValue()
  },
  methods: {
    get,
    getPlaceholder(type, label) {
      return type == 'el-select' ? `請選擇${label}` : `請輸入${label}`
    },
    initRequest() {
      if (!Array.isArray(this.formColumn)) return
      // 根據實際請求接口地址的前綴來判斷
      const urls = this.formColumn?.filter((item) => item.url && item.url.indexOf('/emes') == 0) || []
      urls.forEach(async (item) => {
        const data = { page: { pageIndex: 1, pageSize: 0 }, ...item.requestParams }
        const { detail } = await request({
          url: item.url,
          method: 'post',
          data
        }) || []
        const finalResult = detail.map((result) => ({
          label: result[item.requestLabel],
          value: result[item.requestValue]
        }))
        this.$set(item, 'dic', finalResult)
      })
    },
    initRules() {
      if (!Array.isArray(this.formColumn)) return
      this.formColumn?.forEach((item) => {
        if (item.rules) {
          item.rules.map((rule, index) => {
            if (rule.required) {
              item.rules.splice(index, 1, {
                message: ['el-radio-group', 'el-checkbox-group'].includes(item.type) ? `${item.label}必選` : `${item.label}必填`,
                ...rule
              })
            }
          })
          this.$set(this.formRules, item.prop, item.rules)
        }
      })
    },
    initValue() {
      const selectList = this.formColumn.filter((item) => ['el-radio-group', 'el-checkbox-group'].includes(item.type))
      selectList.forEach((item) => {
        this.$set(this.form, item.prop, item.type == 'el-radio-group' ? item.dic[0].label : [item.dic[0].value])
      })
    }
  }
}
</script>

2. 父組件

<template>
  <div class="app-container">
    <myForm :option="option" :form="form">
      <template #usageSlot="{form, prop}">
        <el-input 
          size="small" 
          placeholder="請輸入插槽使用" 
          v-model="form[prop]" 
          clearable
        >
        </el-input>
      </template>
    </myForm>
  </div>
</template>
<script>
import { option } from './const.js'
export default {
  data() {
    return {
      option,
      form: {}
    }
  }
}
</script>

3. 配置項

export const option = {
  column: [
    {
      label: '姓名',
      prop: 'name',
      span: 8,
      rules: [
        {
          required: true
        }
      ]
    },
    {
      label: '職業',
      prop: 'job',
      type: 'el-select',
      span: 8,
      dic: [
        {
          label: '教師',
          value: 0
        },
        {
          label: '程序猿',
          value: 1
        },
        {
          label: '作傢',
          value: 2
        }
      ],
      rules: [
        {
          required: true
        }
      ]
    },
    {
      label: '性別',
      prop: 'sex',
      span: 8,
      type: 'el-radio-group',
      dic: [
        {
          label: 0,
          value: '男'
        },
        {
          label: 1,
          value: '女'
        }
      ],
      rules: [
        {
          required: true
        }
      ]
    },
    {
      label: '城市',
      prop: 'city',
      type: 'el-checkbox-group',
      span: 8,
      dic: [
        {
          label: '仙桃',
          value: 0
        },
        {
          label: '泉州',
          value: 1
        },
        {
          label: '武漢',
          value: 2
        }
      ],
      rules: [
        {
          required: true
        }
      ]
    },
    {
      label: '出生日期',
      prop: 'data',
      type: 'el-date-picker',
      span: 8,
      rules: [
        {
          required: true
        }
      ]
    },
    {
      label: '測試',
      prop: 'test',
      type: 'el-select',
      span: 8,
      url:'/emes/factoryOrderService/warehouse/list',
      requestLabel: 'warehouseName',
      requestValue: 'id',
      rules: [
        {
          required: true
        }
      ]
    },
    {
      label: '插槽使用',
      prop: 'usage',
      slotName: 'usageSlot',
      span: 8,
      rules: [
        {
          required: true
        }
      ]
    }
  ]
}

4. 添加或編輯

添加：如果是添加狀態，直接在父組件中引入就好。在點擊確定按鈕時，拿到子組件的ref並進行表單校驗。校驗通過後，使用後端定義好的接口進行傳參；
編輯：如果是編輯狀態，則需要在父組件頁面初始化時，將後端返回的數據使用$set進行初始賦值，其餘操作同添加狀態。

以上就是vue封裝form表單組件拒絕重復寫form表單的詳細內容，更多關於vue封裝form表單組件的資料請關註WalkonNet其它相關文章！

vue封裝form表單組件拒絕重復寫form表單

目錄

前言

核心思想：

實現重點：

表單雙向綁定的方式有兩種:

1.使用v-model進行雙向綁定

2.使用v-model的語法糖

配置項

整體字段：

效果瀏覽

源碼放送

1. baseForm組件

2. 父組件

3. 配置項

4. 添加或編輯

推薦閱讀：

發佈留言取消回覆

近期文章

目錄

前言

核心思想：

實現重點：

表單雙向綁定的方式有兩種:

1.使用v-model進行雙向綁定

2.使用v-model的語法糖

配置項

整體字段：

效果瀏覽

源碼放送

1. baseForm組件

2. 父組件

3. 配置項

4. 添加或編輯

推薦閱讀：

發佈留言 取消回覆

近期文章

標籤

發佈留言取消回覆