版本升级到3.0.4：

1. 新增必填校验自定义提示属性requiredHint； 2. 当容器被设置隐藏时，同步清除容器内所有字段的校验规则； 3. 设计器、渲染器新增两个API方法：getFieldWidgets()、getContainerWidgets()； 4. field-list-api属性允许传递请求头信息； 5. 修复异步请求时setFormData()函数可能失效的问题； 6. 修复其他部分bug。
2025-06-21 17:39:57 +08:00 · 2022-03-08 17:59:10 +08:00
parent 471c979abb
commit 486ceafce1
17 changed files with 245 additions and 15 deletions
--- a/src/components/form-designer/form-widget/field-widget/fieldMixin.js
+++ b/src/components/form-designer/form-widget/field-widget/fieldMixin.js
@ -34,6 +34,13 @@ export default {
  methods: {

    //--------------------- 组件内部方法 begin ------------------//
+    getPropName() {
+      if (this.subFormItemFlag && !this.designState) {
+        return this.subFormName + "." + this.subFormRowIndex + "." + this.field.options.name + ""
+      } else {
+        return this.field.options.name
+      }
+    },

    initFieldModel() {
      if (!this.field.formItemFlag) {
@ -201,7 +208,7 @@ export default {
          required: true,
          //trigger: ['blur', 'change'],
          trigger: ['blur'],  /* 去掉change事件触发校验，change事件触发时formModel数据尚未更新，导致radio/checkbox必填校验出错！！ */
-          message: this.i18nt('render.hint.fieldRequired'),
+          message: this.field.options.requiredHint || this.i18nt('render.hint.fieldRequired'),
        })
      }

@ -320,8 +327,7 @@ export default {
      this.oldFieldValue = deepClone(value)  /* oldFieldValue需要在initFieldModel()方法中赋初值!! */

      /* 主动触发表单的单个字段校验，用于清除字段可能存在的校验错误提示 */
-      this.dispatch('VFormRender', 'fieldValidation', [this.field.options.name])
-      // eventBus.$emit('fieldValidation', [this.field.options.name])
+      this.dispatch('VFormRender', 'fieldValidation', [this.getPropName()])
    },

    handleFocusCustomEvent(event) {
@ -343,6 +349,9 @@ export default {
    handleInputCustomEvent(value) {
      this.syncUpdateFormModel(value)

+      /* 主动触发表单的单个字段校验，用于清除字段可能存在的校验错误提示 */
+      this.dispatch('VFormRender', 'fieldValidation', [this.getPropName()])
+
      if (!!this.field.options.onInput) {
        let customFn = new Function('value', this.field.options.onInput)
        customFn.call(this, value)
--- a/src/components/form-designer/index.vue
+++ b/src/components/form-designer/index.vue
@ -68,7 +68,8 @@
  import SettingPanel from './setting-panel/index'
  import VFormWidget from './form-widget/index'
  import {createDesigner} from "@/components/form-designer/designer"
-  import {addWindowResizeHandler, deepClone, getQueryParam} from "@/utils/util"
+  import {addWindowResizeHandler, deepClone, getQueryParam, getAllContainerWidgets,
+    getAllFieldWidgets} from "@/utils/util"
  import {MOCK_CASE_URL, VARIANT_FORM_VERSION} from "@/utils/config"
  import i18n, { changeLocale } from "@/utils/i18n"
  import axios from 'axios'
@ -243,7 +244,8 @@
          return
        }

-        axios.get(this.fieldListApi.URL).then(res => {
+        let headers = this.fieldListApi.headers || {}
+        axios.get(this.fieldListApi.URL, {'headers': headers}).then(res => {
          let labelKey = this.fieldListApi.labelKey || 'label'
          let nameKey = this.fieldListApi.nameKey || 'name'

@ -340,6 +342,22 @@
        this.$refs.toolbarRef.generateSFC()
      },

+      /**
+       * 获取所有字段组件
+       * @returns {*[]}
+       */
+      getFieldWidgets() {
+        return getAllFieldWidgets(this.designer.widgetList)
+      },
+
+      /**
+       * 获取所有容器组件
+       * @returns {*[]}
+       */
+      getContainerWidgets() {
+        return getAllContainerWidgets(this.designer.widgetList)
+      },
+
      //TODO: 增加更多方法！！

    }
--- a/src/components/form-designer/setting-panel/property-editor/requiredHint-editor.vue
+++ b/src/components/form-designer/setting-panel/property-editor/requiredHint-editor.vue
@ -0,0 +1,24 @@
+<template>
+  <el-form-item :label="i18nt('designer.setting.requiredHint')">
+    <el-input type="text" v-model="optionModel.requiredHint"></el-input>
+  </el-form-item>
+</template>
+
+<script>
+  import i18n from "@/utils/i18n"
+  import propertyMixin from "@/components/form-designer/setting-panel/property-editor/propertyMixin"
+
+  export default {
+    name: "requiredHint-editor",
+    mixins: [i18n, propertyMixin],
+    props: {
+      designer: Object,
+      selectedWidget: Object,
+      optionModel: Object,
+    },
+  }
+</script>
+
+<style scoped>
+
+</style>
--- a/src/components/form-designer/setting-panel/propertyRegister.js
+++ b/src/components/form-designer/setting-panel/propertyRegister.js
@ -24,6 +24,7 @@ const COMMON_PROPERTIES = {
  'labelHidden'       :            'labelHidden-editor',
  'rows'              :            'rows-editor',
  'required'          :            'required-editor',
+  'requiredHint'      :            'requiredHint-editor',
  'validation'        :            'validation-editor',
  'validationHint'    :            'validationHint-editor',
  'readonly'          :            'readonly-editor',
--- a/src/components/form-designer/toolbar-panel/index.vue
+++ b/src/components/form-designer/toolbar-panel/index.vue
@ -62,6 +62,7 @@
            <el-button type="primary" @click="setFormDisabled">{{i18nt('designer.hint.disableForm')}}</el-button>
            <el-button type="primary" @click="setFormEnabled">{{i18nt('designer.hint.enableForm')}}</el-button>
            <el-button @click="showPreviewDialogFlag = false">{{i18nt('designer.hint.closePreview')}}</el-button>
+            <el-button v-if="false" @click="testLoadForm">Test Load</el-button>
          </div>
        </template>
      </el-dialog>
@ -594,6 +595,23 @@
        this.$refs['preForm'].enableForm()
      },

+      testLoadForm() {
+        axios.get('https://www.fastmock.site/mock/e9710039bb5f11262d1a0f2f0bbe08c8/vform3/getFS').then(res => {
+          let newFormJson = res.data
+          this.$refs.preForm.setFormJson(newFormJson)
+          // let newFormData = {'input30696': '668899'}
+          // this.$refs.preForm.setFormData(newFormData)
+
+          console.log('test', 'aaaaaaaa')
+          this.$nextTick(() => {
+            let newFormData = {'input30696': '668899'}
+            this.$refs.preForm.setFormData(newFormData)
+          })
+        }).catch(err => {
+          //
+        })
+      },
+
      handleFormChange(fieldName, newValue, oldValue, formModel) {
        /*
        console.log('---formChange start---')
--- a/src/components/form-designer/widget-panel/widgetsConfig.js
+++ b/src/components/form-designer/widget-panel/widgetsConfig.js
@ -118,6 +118,7 @@ export const basicFields = [
      clearable: true,
      showPassword: false,
      required: false,
+      requiredHint: '',
      validation: '',
      validationHint: '',
      //-------------------
@ -163,6 +164,7 @@ export const basicFields = [
      disabled: false,
      hidden: false,
      required: false,
+      requiredHint: '',
      validation: '',
      validationHint: '',
      //-------------------
@ -201,6 +203,7 @@ export const basicFields = [
      disabled: false,
      hidden: false,
      required: false,
+      requiredHint: '',
      validation: '',
      validationHint: '',
      //-------------------
@ -247,6 +250,7 @@ export const basicFields = [
        {label: 'radio 3', value: 3},
      ],
      required: false,
+      requiredHint: '',
      validation: '',
      validationHint: '',
      //-------------------
@ -286,6 +290,7 @@ export const basicFields = [
        {label: 'check 3', value: 3},
      ],
      required: false,
+      requiredHint: '',
      validation: '',
      validationHint: '',
      //-------------------
@ -330,6 +335,7 @@ export const basicFields = [
        {label: 'select 3', value: 3},
      ],
      required: false,
+      requiredHint: '',
      validation: '',
      validationHint: '',
      //-------------------
@ -370,6 +376,7 @@ export const basicFields = [
      editable: false,
      format: 'HH:mm:ss',  //时间格式
      required: false,
+      requiredHint: '',
      validation: '',
      validationHint: '',
      //-------------------
@ -410,6 +417,7 @@ export const basicFields = [
      editable: false,
      format: 'HH:mm:ss',  //时间格式
      required: false,
+      requiredHint: '',
      validation: '',
      validationHint: '',
      //-------------------
@ -451,6 +459,7 @@ export const basicFields = [
      format: 'YYYY-MM-DD',  //日期显示格式
      valueFormat: 'YYYY-MM-DD',  //日期对象格式
      required: false,
+      requiredHint: '',
      validation: '',
      validationHint: '',
      //-------------------
@ -493,6 +502,7 @@ export const basicFields = [
      format: 'YYYY-MM-DD',  //日期显示格式
      valueFormat: 'YYYY-MM-DD',  //日期对象格式
      required: false,
+      requiredHint: '',
      validation: '',
      validationHint: '',
      //-------------------
@ -557,6 +567,7 @@ export const basicFields = [
      disabled: false,
      hidden: false,
      required: false,
+      requiredHint: '',
      validation: '',
      validationHint: '',
      //-------------------
@ -594,6 +605,7 @@ export const basicFields = [
      disabled: false,
      hidden: false,
      required: false,
+      requiredHint: '',
      validation: '',
      validationHint: '',
      //-------------------
@ -625,6 +637,7 @@ export const basicFields = [
      disabled: false,
      hidden: false,
      required: false,
+      requiredHint: '',
      validation: '',
      validationHint: '',
      //-------------------
--- a/src/components/form-render/container-item/containerItemMixin.js
+++ b/src/components/form-render/container-item/containerItemMixin.js
@ -1,4 +1,4 @@
-import {generateId} from "@/utils/util";
+import { traverseFieldWidgetsOfContainer } from "@/utils/util";

 export default {
  computed: {
@ -14,6 +14,9 @@ export default {
    },

  },
+  mounted() {
+    this.callSetHidden()
+  },

  methods: {
    unregisterFromRefList() {  //销毁容器组件时注销组件ref
@ -23,11 +26,33 @@ export default {
      }
    },

+    /* 主动触发setHidden()方法，以清空被隐藏容器内字段组件的校验规则！！ */
+    callSetHidden() {
+      if (this.widget.options.hidden === true) {
+        this.setHidden(true)
+      }
+    },
+
    //--------------------- 以下为组件支持外部调用的API方法 begin ------------------//
    /* 提示：用户可自行扩充这些方法！！！ */

    setHidden(flag) {
      this.widget.options.hidden = flag
+
+      /* 容器被隐藏后，需要同步清除容器内部字段组件的校验规则 */
+      let clearRulesFn = (fieldWidget) => {
+        let fwName = fieldWidget.options.name
+        let fwRef = this.getWidgetRef(fwName)
+        if (flag && !!fwRef && !!fwRef.clearFieldRules) {
+          fwRef.clearFieldRules()
+        }
+
+        if (!flag && !!fwRef && !!fwRef.buildFieldRules) {
+          fwRef.buildFieldRules()
+        }
+      }
+
+      traverseFieldWidgetsOfContainer(this.widget, clearRulesFn)
    },

    activeTab(tabIndex) { //tabIndex从0计数
--- a/src/components/form-render/index.vue
+++ b/src/components/form-render/index.vue
@ -41,7 +41,8 @@
  import emitter from '@/utils/emitter'
  import './container-item/index'
  import FieldComponents from '@/components/form-designer/form-widget/field-widget/index'
-  import {deepClone, insertCustomCssToHead, insertGlobalFunctionsToHtml} from "@/utils/util"
+  import {deepClone, insertCustomCssToHead, insertGlobalFunctionsToHtml, getAllContainerWidgets,
+    getAllFieldWidgets} from "@/utils/util"
  import i18n, { changeLocale } from "@/utils/i18n"
  import eventBus from "@/utils/event-bus"

@ -549,7 +550,23 @@
            })
          }
        }
-      }
+      },
+
+      /**
+       * 获取所有字段组件
+       * @returns {*[]}
+       */
+      getFieldWidgets() {
+        return getAllFieldWidgets(this.formJsonObj.widgetList)
+      },
+
+      /**
+       * 获取所有容器组件
+       * @returns {*[]}
+       */
+      getContainerWidgets() {
+        return getAllContainerWidgets(this.formJsonObj.widgetList)
+      },

      //--------------------- 以上为组件支持外部调用的API方法 end ------------------//