@ibiz-template/runtime 0.0.1-alpha.9 → 0.0.1-beta.17

package/src/controller/control/form/form-detail.ts

@@ -0,0 +1,224 @@
+import { isOverlap } from '@ibiz-template/core';
+import { FormDetailModel } from '@ibiz-template/model';
+import { IBizVerify } from '../../../service';
+import { FormNotifyState } from '../../constant';
+import { FormController, FormContainerController } from '.';
+import { ILayoutController } from '../../interface';
+
+export class FormDetailController<T extends FormDetailModel = FormDetailModel> {
+  /**
+   * 表单成员模型
+   *
+   * @author lxm
+   * @date 2022-08-24 20:08:19
+   * @type {T}
+   */
+  readonly model: T;
+
+  /**
+   * 表单控制器
+   *
+   * @author lxm
+   * @date 2022-08-24 22:08:59
+   * @type {FormController}
+   */
+  readonly form: FormController;
+
+  /**
+   * 父容器控制器(除了表单分页都存在)
+   *
+   * @author lxm
+   * @date 2022-08-24 22:08:59
+   * @type {FormController}
+   */
+  readonly parent?: FormContainerController;
+
+  /**
+   * 自身的逻辑判断是否显示
+   *
+   * @author lxm
+   * @date 2022-09-01 21:09:24
+   * @type {boolean}
+   */
+  $visible: boolean = true;
+
+  /**
+   * 实际是否显示，取决于自身和父容器的显示与否
+   *
+   * @author lxm
+   * @date 2022-09-04 16:09:11
+   * @readonly
+   */
+  get visible(): boolean {
+    return this.parent!.visible && this.$visible;
+  }
+
+  /**
+   * 是否必填
+   *
+   * @author lxm
+   * @date 2022-09-01 21:09:34
+   * @type {boolean}
+   */
+  required: boolean = false;
+
+  $disabled: boolean = false;
+
+  /**
+   * 是否禁用
+   *
+   * @author lxm
+   * @date 2022-09-01 21:09:44
+   * @type {boolean}
+   */
+  get disabled() {
+    return this.$disabled;
+  }
+
+  set disabled(val) {
+    this.$disabled = val;
+  }
+
+  /**
+   * 布局控制器
+   *
+   * @author lxm
+   * @date 2022-10-20 17:10:27
+   * @type {ILayoutController}
+   */
+  layoutController: ILayoutController = {
+    width: '100%',
+    height: '100%',
+    extraStyle: {},
+    extraClass: '',
+  };
+
+  /**
+   * Creates an instance of FormDetailController.
+   * @author lxm
+   * @date 2022-08-24 20:08:22
+   * @param {T} model
+   */
+  constructor(
+    model: T,
+    form: FormController,
+    parent?: FormContainerController,
+  ) {
+    this.model = model;
+    this.form = form;
+    this.parent = parent;
+  }
+
+  /**
+   * 子类不可覆盖或重写此方法，在 init 时需要重写的使用 onInit 方法。
+   *
+   * @author lxm
+   * @date 2022-08-18 22:08:30
+   * @returns {*}  {Promise<void>}
+   */
+  async init(): Promise<void> {
+    await this.onInit();
+  }
+
+  protected async onInit(): Promise<void> {
+    // 初始化布局参数
+    if (this.model.width) {
+      this.layoutController.width = this.model.width;
+    }
+    if (this.model.height) {
+      this.layoutController.height = this.model.height;
+    }
+
+    // 给col添加各自类型的类名
+    this.layoutController.extraClass = `ibiz-form-col__${this.model.source.detailType.toLowerCase()} `;
+    if (this.model.source.getPSSysCss()) {
+      this.layoutController.extraClass +=
+        this.model.source.getPSSysCss()!.cssName;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-this-alias
+    const _this = this;
+    Object.defineProperty(_this.layoutController, 'visible', {
+      configurable: true,
+      enumerable: true,
+      get() {
+        return _this.visible;
+      },
+    });
+  }
+
+  /**
+   * 表单数据变更通知(由表单控制器调用)
+   *
+   * @author lxm
+   * @date 2022-09-20 18:09:56
+   * @param {string[]} names
+   */
+  dataChangeNotify(names: string[]): void {
+    // 计算动态控制逻辑
+    this.calcDynamicLogic(names);
+  }
+
+  /**
+   * 表单状态变更通知
+   *
+   * @author lxm
+   * @date 2022-09-20 18:09:07
+   */
+  formStateNotify(state: FormNotifyState): void {
+    // 计算动态控制逻辑
+    this.calcDynamicLogic([], state);
+  }
+
+  /**
+   * 计算动态逻辑
+   *
+   * @author lxm
+   * @date 2022-09-20 19:09:20
+   * @protected
+   * @param {string[]} names 变更的属性集合
+   * @param {FormNotifyState} [state] 表单通知状态
+   * @returns {*}  {void}
+   */
+  protected calcDynamicLogic(names: string[], state?: FormNotifyState): void {
+    // 逻辑优化，当父容器存在且为不显示时，不去计算自己的动态逻辑
+    if (this.parent && !this.parent.visible) {
+      return;
+    }
+
+    // 根据自身的动态逻辑计算
+    this.model.source.getPSDEFDGroupLogics()?.forEach(logic => {
+      const relatedNames = logic.getRelatedDetailNames() || [];
+      // name是动态逻辑涉及到的时或state存在时
+      if (state || isOverlap(relatedNames, names)) {
+        const ok = IBizVerify.verifyGroupLogic(this.form.data, logic);
+        switch (logic.logicCat) {
+          // 动态空输入，不满足则必填
+          case 'ITEMBLANK':
+            this.required = !ok;
+            break;
+          // 动态启用，满足则启用
+          case 'ITEMENABLE':
+            this.disabled = !ok;
+            break;
+          // 动态显示，满足则显示
+          case 'PANELVISIBLE':
+            this.$visible = ok;
+            break;
+          default:
+        }
+      }
+    });
+  }
+
+  /**
+   * 强制更新视图
+   *
+   * @author lxm
+   * @date 2022-09-15 09:09:05
+   * @param {() => void} [_callback] 更新之后，组件渲染完成后的回调
+   */
+  force(_callback?: () => void): void {
+    // 在界面数据发生变更时，会调用此方法。
+    // 可外部覆盖实例的此方法，实现自定义的数据更新逻辑。
+  }
+}

package/src/controller/control/form/form-druipart.ts

@@ -0,0 +1,174 @@
+import { IBizContext, isOverlap } from '@ibiz-template/core';
+import { FormDRUIPartModel } from '@ibiz-template/model';
+import { notNilEmpty, createUUID } from 'qx-util';
+import { FormNotifyState } from '../../constant';
+import { ViewNeuron } from '../../neuron/neuron/view';
+import { EditFormController, FormDetailController } from '.';
+import { convertNavData } from '../../../utils';
+
+/**
+ * 表单关系界面控制器
+ *
+ * @author lxm
+ * @date 2022-09-04 15:09:52
+ * @export
+ * @class FormDRUIPartController
+ * @extends {FormDetailController}
+ */
+export class FormDRUIPartController extends FormDetailController<FormDRUIPartModel> {
+  /**
+   * 关系界面的上下文
+   *
+   * @author lxm
+   * @date 2022-09-14 18:09:32
+   * @type {IContext}
+   */
+  context!: IContext;
+
+  /**
+   * 关系界面的视图参数
+   *
+   * @author lxm
+   * @date 2022-09-14 18:09:42
+   * @type {IParams}
+   */
+  params!: IParams;
+
+  /**
+   * 关系界面组件绑的key，用来触发强制刷新
+   *
+   * @author lxm
+   * @date 2022-09-15 20:09:21
+   * @type {string}
+   */
+  viewComponentKey?: string;
+
+  /**
+   * 嵌入视图神经元
+   *
+   * @author lxm
+   * @date 2022-09-15 10:09:18
+   * @type {ViewNeuron}
+   */
+  neuron!: ViewNeuron;
+
+  protected async onInit(): Promise<void> {
+    await super.onInit();
+    Object.assign(this.layoutController.extraStyle, {
+      overflow: 'auto',
+    });
+  }
+
+  /**
+   * 表单数据变更通知(由表单控制器调用)
+   *
+   * @author lxm
+   * @date 2022-09-01 20:09:54
+   * @param {String[]} names
+   */
+  dataChangeNotify(names: string[]): void {
+    super.dataChangeNotify(names);
+
+    // 关联刷新项发生变更时触发刷新
+    if (isOverlap(this.model.refreshItems, names)) {
+      this.calcViewParams();
+    }
+  }
+
+  formStateNotify(state: FormNotifyState): void {
+    super.formStateNotify(state);
+
+    // 表单数据加载变更后，计算关系界面参数
+    this.calcViewParams();
+  }
+
+  /**
+   * 计算视图上下文和视图参数,并刷新视图
+   *
+   * @author lxm
+   * @date 2022-09-14 18:09:35
+   */
+  calcViewParams(): void {
+    // 计算导航上下文
+    let newContext = new IBizContext({}, this.form.context);
+    const navContexts = this.model.source.getPSNavigateContexts();
+    if (notNilEmpty(navContexts)) {
+      newContext = Object.assign(
+        newContext,
+        convertNavData(
+          navContexts!,
+          this.form.context,
+          this.form.params,
+          this.form.data,
+        ),
+      );
+    }
+
+    // 处理导航视图参数
+    const navParams = this.model.source.getPSNavigateParams();
+    let newParams = {};
+    if (notNilEmpty(navParams)) {
+      newParams = convertNavData(
+        navParams!,
+        this.form.params,
+        this.form.context,
+        this.form.data,
+      );
+    }
+
+    // this.neuron不存在时，关系界面还没有渲染，第一次创建UUID
+    // 视图参数或上下文发生改变时变更key，销毁重绘视图
+    if (
+      !this.neuron ||
+      !this.context ||
+      JSON.stringify(this.context) !== JSON.stringify(newContext) ||
+      JSON.stringify(this.params) !== JSON.stringify(newParams)
+    ) {
+      this.refresh(true);
+    } else {
+      // 不变的情况重新加载视图的数据
+      this.refresh();
+    }
+    this.context = newContext;
+    this.params = newParams;
+    this.force();
+  }
+
+  /**
+   * 刷新视图
+   *
+   * @author lxm
+   * @date 2022-09-22 11:09:06
+   * @param {boolean} isReset 是否重置
+   */
+  refresh(isReset: boolean = false) {
+    if (isReset) {
+      this.viewComponentKey = createUUID();
+    } else {
+      this.neuron.call.refresh();
+    }
+  }
+
+  /**
+   * 设置嵌入视图的神经元
+   *
+   * @author lxm
+   * @date 2022-09-15 10:09:22
+   * @param {ViewNeuron} neuron
+   */
+  setViewNeuron(neuron: ViewNeuron) {
+    this.neuron = neuron;
+    // 监听mounted事件，如果没有遮罩的时候通知加载
+    neuron.evt.on('mounted', () => {
+      neuron.call.refresh();
+    });
+    this.neuron.evt.on('refreshed', data => {
+      ibiz.log.debug('接收到关系界面的刷新变更事件', data);
+      // 有表单项更新，且是自身变更时，触发表单项更新
+      if (this.model.formItemUpdate) {
+        const { methodName, itemNames } = this.model.formItemUpdate;
+        (this.form as EditFormController).updateFormItem(methodName, itemNames);
+      }
+    });
+  }
+}

package/src/controller/control/form/form-group-panel.ts

@@ -0,0 +1,12 @@
+import { FormContainerController } from '.';
+
+/**
+ * 表单分组面板控制器
+ *
+ * @author lxm
+ * @date 2022-09-04 15:09:52
+ * @export
+ * @class FormGroupPanelController
+ * @extends {FormContainerController}
+ */
+export class FormGroupPanelController extends FormContainerController {}