@gct-paas/core-web 0.1.4-dev.10 → 0.1.4-dev.11

package/es/modules/gct-form/controller/form-edit-item/form-edit-item.controller.d.ts

@@ -0,0 +1,27 @@
+import { IFormEditItem, IFormEditItemController, IFormEditItemState } from '../../interface';
+import { FormItemBasicController } from '../form-item-basic/form-item-basic.controller';
+/**
+ * 表单编辑项控制器
+ *
+ * @author zhanghanrui
+ * @date 2024-04-02 20:04:00
+ * @export
+ * @abstract
+ * @class FormEditItemController
+ * @extends {FormItemBasicController}
+ * @implements {IFormEditItemController}
+ */
+export declare abstract class FormEditItemController extends FormItemBasicController implements IFormEditItemController {
+    model: IFormEditItem;
+    state: IFormEditItemState;
+    get key(): string;
+    get value(): any;
+    set value(value: any);
+    get editorValue(): any;
+    set editorValue(v: any);
+    protected init(): void;
+    blur(): void;
+    defaultValue(): void;
+    reset(): void;
+    protected crateItemState(): IFormEditItemState;
+}

package/es/modules/gct-form/controller/form-edit-item/form-edit-item.controller.mjs

@@ -0,0 +1,94 @@
+import { cloneDeep } from 'lodash-es';
+import { FormItemBasicController } from '../form-item-basic/form-item-basic.controller.mjs';
+import { FormEditItemState } from '../../state/form-edit-item/form-edit-item.state.mjs';
+
+class FormEditItemController extends FormItemBasicController {
+  get key() {
+    return this.model.field ?? this.model.name;
+  }
+  get value() {
+    return getValue(this.key, this.form.state.data);
+  }
+  set value(value) {
+    const data = this.form.state.data;
+    const oldValue = cloneDeep(getValue(this.key, data));
+    setValue(value, this.key, data);
+    this.form.evt.emit("change", this.key, value, oldValue);
+    this.state.value = value;
+  }
+  get editorValue() {
+    if (this.model.fields) {
+      return this.model.fields.map((key) => {
+        return this.form.item[key].value;
+      });
+    }
+    return this.value;
+  }
+  set editorValue(v) {
+    if (this.model.fields) {
+      this.model.fields.forEach((key, i) => {
+        this.form.item[key].value = v?.[i];
+      });
+    } else {
+      this.value = v;
+    }
+  }
+  init() {
+    super.init();
+    if (this.model.type !== "hidden") {
+      const { editor } = this.model;
+      this.state.readonly = editor.readonly;
+      if (editor.disabled != null) {
+        this.state.disabled = editor.disabled;
+      }
+    }
+    if (this.model.dictionary) {
+      const { mode } = this.model.dictionary;
+      if (mode === "static") {
+        this.state.options = this.model.dictionary.items || [];
+      }
+    }
+  }
+  blur() {
+    if ((this.state.value == null || this.state.value === "") && this.model.defaultValue != null) {
+      this.value = this.model.defaultValue;
+      this.form.evt.emit("blur", this.key, this.value);
+    }
+  }
+  defaultValue() {
+    const data = this.form.state.data;
+    if (getValue(this.key, data) == null && this.model.defaultValue != null) {
+      setValue(this.model.defaultValue, this.key, data);
+    }
+  }
+  reset() {
+    if (this.model.defaultValue !== void 0) {
+      this.value = this.model.defaultValue;
+    } else {
+      this.value = void 0;
+    }
+  }
+  crateItemState() {
+    return new FormEditItemState();
+  }
+}
+function getValue(name, data) {
+  const key_list = name.split(".");
+  try {
+    return key_list.reduce((memo, cur) => memo[cur], data);
+  } catch (err) {
+    console.warn(err);
+  }
+}
+function setValue(value, name, data) {
+  const key_list = name.split(".");
+  const len = key_list.length - 1;
+  key_list.reduce((memo, cur, index) => {
+    if (index === len) {
+      memo[cur] = value;
+    }
+    return memo[cur];
+  }, data);
+}
+
+export { FormEditItemController };

package/es/modules/gct-form/controller/form-group/form-group.controller.d.ts

@@ -0,0 +1,18 @@
+import { IFormGroup, IFormGroupController, IFormGroupState } from '../../interface';
+import { FormItemBasicController } from '../form-item-basic/form-item-basic.controller';
+/**
+ * 表单分组控制器
+ *
+ * @author zhanghanrui
+ * @date 2024-04-01 14:04:00
+ * @export
+ * @class FormGroupController
+ * @extends {FormItemBasicController}
+ * @implements {IFormGroupController}
+ */
+export declare class FormGroupController extends FormItemBasicController implements IFormGroupController {
+    readonly type = "group";
+    model: IFormGroup;
+    state: IFormGroupState;
+    protected crateItemState(): IFormGroupState;
+}

package/es/modules/gct-form/controller/form-group/form-group.controller.mjs

@@ -0,0 +1,11 @@
+import { FormGroupState } from '../../state/form-group/form-group.state.mjs';
+import { FormItemBasicController } from '../form-item-basic/form-item-basic.controller.mjs';
+
+class FormGroupController extends FormItemBasicController {
+  type = "group";
+  crateItemState() {
+    return new FormGroupState();
+  }
+}
+
+export { FormGroupController };

package/es/modules/gct-form/controller/form-item/form-item.controller.d.ts

@@ -0,0 +1,21 @@
+import { IDictionaryItem } from '@gct-paas/core';
+import { IFormItem, IFormItemController, IFormItemState } from '../../interface';
+import { FormEditItemController } from '../form-edit-item/form-edit-item.controller';
+/**
+ * 表单项控制器
+ *
+ * @author zhanghanrui
+ * @date 2024-04-02 20:04:03
+ * @export
+ * @class FormItemController
+ * @extends {FormEditItemController}
+ * @implements {IFormItemController}
+ */
+export declare class FormItemController extends FormEditItemController implements IFormItemController {
+    readonly type = "item";
+    model: IFormItem;
+    state: IFormItemState;
+    loadDictionary(params?: IParams, force?: boolean): Promise<IDictionaryItem[]>;
+    clearDictionary(): void;
+    protected crateItemState(): IFormItemState;
+}

package/es/modules/gct-form/controller/form-item/form-item.controller.mjs

@@ -0,0 +1,37 @@
+import { FormItemState } from '../../state/form-item/form-item.state.mjs';
+import { FormEditItemController } from '../form-edit-item/form-edit-item.controller.mjs';
+
+class FormItemController extends FormEditItemController {
+  type = "item";
+  async loadDictionary(params, force) {
+    if (this.state.options.length > 0 && force !== true) {
+      return this.state.options;
+    }
+    this.state.options = [];
+    this.state.loading = true;
+    try {
+      if (this.model.dictionary) {
+        this.state.options = await _gct.dictionary.asyncGetByConfig(
+          this.model.dictionary,
+          params
+        );
+      } else if (this.model.dictionaryTag) {
+        this.state.options = await _gct.dictionary.asyncGet(
+          this.model.dictionaryTag,
+          params
+        );
+      }
+      return this.state.options;
+    } finally {
+      this.state.loading = false;
+    }
+  }
+  clearDictionary() {
+    this.state.options = [];
+  }
+  crateItemState() {
+    return new FormItemState();
+  }
+}
+
+export { FormItemController };

package/es/modules/gct-form/controller/form-item-basic/form-item-basic.controller.d.ts

@@ -0,0 +1,57 @@
+import { IFormController, IFormItemBasic, IFormItemBasicController, IFormItemBasicState } from '../../interface';
+/**
+ * 表单项基础控制器
+ *
+ * @author zhanghanrui
+ * @date 2024-04-01 14:04:08
+ * @export
+ * @abstract
+ * @class FormItemBasicController
+ * @implements {IFormItemBasicController}
+ */
+export declare abstract class FormItemBasicController implements IFormItemBasicController {
+    protected readonly form: IFormController;
+    readonly model: IFormItemBasic;
+    /**
+     * 表单项类型
+     *
+     * @author zhanghanrui
+     * @date 2024-04-01 14:04:45
+     * @abstract
+     * @type {string}
+     */
+    abstract readonly type: string;
+    /**
+     * 表单项基础状态
+     *
+     * @description 禁止直接重写new实例，如果要覆盖重写 crateItemState 方法
+     * @author zhanghanrui
+     * @date 2024-04-02 22:04:07
+     * @type {IFormItemBasicState}
+     */
+    state: IFormItemBasicState;
+    get data(): IData;
+    /**
+     * Creates an instance of FormItemBasicController.
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 09:04:55
+     * @param {IFormController} form
+     * @param {IFormItemBasic} model
+     */
+    constructor(form: IFormController, model: IFormItemBasic);
+    protected init(): void;
+    destroy(): void;
+    protected crateItemState(): IFormItemBasicState;
+}
+/**
+ * 加载表单项控制器实例
+ *
+ * @author zhanghanrui
+ * @date 2024-04-02 22:04:51
+ * @export
+ * @template T
+ * @param {() => T} fn
+ * @return {*}  {T}
+ */
+export declare function useFormItemController<T extends IFormItemBasicController = IFormItemBasicController>(fn: () => T): T;

package/es/modules/gct-form/controller/form-item-basic/form-item-basic.controller.mjs

@@ -0,0 +1,45 @@
+import { reactive } from 'vue';
+import { FormItemBasicState } from '../../state/form-item-basic/form-item-basic.state.mjs';
+
+class FormItemBasicController {
+  /**
+   * Creates an instance of FormItemBasicController.
+   *
+   * @author zhanghanrui
+   * @date 2024-04-02 09:04:55
+   * @param {IFormController} form
+   * @param {IFormItemBasic} model
+   */
+  constructor(form, model) {
+    this.form = form;
+    this.model = model;
+    this.init();
+  }
+  /**
+   * 表单项基础状态
+   *
+   * @description 禁止直接重写new实例，如果要覆盖重写 crateItemState 方法
+   * @author zhanghanrui
+   * @date 2024-04-02 22:04:07
+   * @type {IFormItemBasicState}
+   */
+  state = this.crateItemState();
+  get data() {
+    return this.form.state.data;
+  }
+  init() {
+  }
+  destroy() {
+    this.state.destroyed = true;
+  }
+  crateItemState() {
+    return new FormItemBasicState();
+  }
+}
+function useFormItemController(fn) {
+  const c = fn();
+  c.state = reactive(c.state);
+  return c;
+}
+
+export { FormItemBasicController, useFormItemController };

package/es/modules/gct-form/controller/form-item-hidden/form-item-hidden.controller.d.ts

@@ -0,0 +1,17 @@
+import { IFormHiddenItem, IFormHiddenItemController, IFormHiddenItemState } from '../../interface';
+import { FormItemBasicController } from '../form-item-basic/form-item-basic.controller';
+/**
+ * 表单分组控制器
+ *
+ * @author zhanghanrui
+ * @date 2024-04-01 14:04:00
+ * @export
+ * @class FormHiddenItemController
+ * @extends {FormEditItemController}
+ * @implements {IFormGroupController}
+ */
+export declare class FormHiddenItemController extends FormItemBasicController implements IFormHiddenItemController {
+    readonly type = "hidden";
+    model: IFormHiddenItem;
+    state: IFormHiddenItemState;
+}

package/es/modules/gct-form/controller/form-item-hidden/form-item-hidden.controller.mjs

@@ -0,0 +1,7 @@
+import { FormItemBasicController } from '../form-item-basic/form-item-basic.controller.mjs';
+
+class FormHiddenItemController extends FormItemBasicController {
+  type = "hidden";
+}
+
+export { FormHiddenItemController };

package/es/modules/gct-form/controller/form-line/form-line.controller.d.ts

@@ -0,0 +1,18 @@
+import { IFormLine, IFormLineController, IFormLineState } from '../../interface';
+import { FormItemBasicController } from '../form-item-basic/form-item-basic.controller';
+/**
+ * 表单分组控制器
+ *
+ * @author zhanghanrui
+ * @date 2024-04-01 14:04:00
+ * @export
+ * @class FormGroupController
+ * @extends {FormItemBasicController}
+ * @implements {IFormGroupController}
+ */
+export declare class FormLineController extends FormItemBasicController implements IFormLineController {
+    readonly type = "line";
+    model: IFormLine;
+    state: IFormLineState;
+    protected crateItemState(): IFormLineState;
+}

package/es/modules/gct-form/controller/form-line/form-line.controller.mjs

@@ -0,0 +1,11 @@
+import { FormLineState } from '../../state/form-line/form-line.state.mjs';
+import { FormItemBasicController } from '../form-item-basic/form-item-basic.controller.mjs';
+
+class FormLineController extends FormItemBasicController {
+  type = "line";
+  crateItemState() {
+    return new FormLineState();
+  }
+}
+
+export { FormLineController };

package/es/modules/gct-form/controller/form-tab/form-tab.controller.d.ts

@@ -0,0 +1,18 @@
+import { IFormTab, IFormTabController, IFormTabState } from '../../interface';
+import { FormItemBasicController } from '../form-item-basic/form-item-basic.controller';
+/**
+ * 表单分组控制器
+ *
+ * @author zhanghanrui
+ * @date 2024-04-01 14:04:00
+ * @export
+ * @class FormTabController
+ * @extends {FormItemBasicController}
+ * @implements {IFormTabController}
+ */
+export declare class FormTabController extends FormItemBasicController implements IFormTabController {
+    readonly type = "tab";
+    model: IFormTab;
+    state: IFormTabState;
+    protected crateItemState(): IFormTabState;
+}

package/es/modules/gct-form/controller/form-tab/form-tab.controller.mjs

@@ -0,0 +1,11 @@
+import { FormTabState } from '../../state/form-tab/form-tab.state.mjs';
+import { FormItemBasicController } from '../form-item-basic/form-item-basic.controller.mjs';
+
+class FormTabController extends FormItemBasicController {
+  type = "tab";
+  crateItemState() {
+    return new FormTabState();
+  }
+}
+
+export { FormTabController };

package/es/modules/gct-form/controller/form-tab-pane/form-tab-pane.controller.d.ts

@@ -0,0 +1,18 @@
+import { IFormTabPane, IFormTabPaneController, IFormTabPaneState } from '../../interface';
+import { FormItemBasicController } from '../form-item-basic/form-item-basic.controller';
+/**
+ * 表单分组控制器
+ *
+ * @author zhanghanrui
+ * @date 2024-04-01 14:04:00
+ * @export
+ * @class FormTabPaneController
+ * @extends {FormItemBasicController}
+ * @implements {IFormTabPaneController}
+ */
+export declare class FormTabPaneController extends FormItemBasicController implements IFormTabPaneController {
+    readonly type = "tab-pane";
+    model: IFormTabPane;
+    state: IFormTabPaneState;
+    protected crateItemState(): IFormTabPaneState;
+}

package/es/modules/gct-form/controller/form-tab-pane/form-tab-pane.controller.mjs

@@ -0,0 +1,11 @@
+import { FormTabPaneState } from '../../state/form-tab-pane/form-tab-pane.state.mjs';
+import { FormItemBasicController } from '../form-item-basic/form-item-basic.controller.mjs';
+
+class FormTabPaneController extends FormItemBasicController {
+  type = "tab-pane";
+  crateItemState() {
+    return new FormTabPaneState();
+  }
+}
+
+export { FormTabPaneController };

package/es/modules/gct-form/controller/gct-form/gct-form.controller.d.ts

@@ -0,0 +1,101 @@
+import { IForm, IFormState, IFormController, IFormItemBasic, IFormItem, IFormItemProvider, IFormItemBasicController, IFormEvent, IFormHiddenItem } from '../../interface';
+import { QXEvent } from 'qx-util';
+/**
+ * 表单控制器
+ *
+ * @author zhanghanrui
+ * @date 2024-04-02 20:04:14
+ * @export
+ * @class GctFormController
+ * @implements {IFormController}
+ */
+export declare class GctFormController implements IFormController {
+    readonly model: IForm;
+    readonly evt: QXEvent<IFormEvent>;
+    state: IFormState;
+    readonly item: Record<string, IFormItemBasicController>;
+    readonly provider: Record<string, IFormItemProvider>;
+    readonly context: IParams;
+    readonly params: IParams;
+    /**
+     * 所有属性的项标识，由 item 和 hidden 类型的表单项的 name 组成
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 20:04:20
+     * @protected
+     * @type {string[]}
+     */
+    protected fields: string[];
+    /**
+     * 所有[item、hidden]表单项的映射，key 为表单项的 name
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 20:04:39
+     * @protected
+     * @type {(Record<string, IFormItem | IFormHiddenItem>)}
+     */
+    protected modelMap: Record<string, IFormItem | IFormHiddenItem>;
+    constructor(model: IForm);
+    /**
+     * 表单初始化
+     *
+     * @author zhanghanrui
+     * @date 2024-04-01 13:04:27
+     * @protected
+     */
+    protected init(): void;
+    /**
+     * 初始化表单事件订阅相关
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 14:04:31
+     * @protected
+     */
+    protected initEvent(): void;
+    /**
+     * 计算表单状态，数据变更或加载数据后调用
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 21:04:15
+     * @protected
+     */
+    protected calcState(): void;
+    /**
+     * 初始化表单项控制器
+     *
+     * @author zhanghanrui
+     * @date 2024-04-01 13:04:38
+     * @protected
+     * @param {IFormItemBasic[]} models
+     */
+    protected initFormItems(models: IFormItemBasic[]): void;
+    /**
+     * 计算表单项隐藏
+     *
+     * @author zhanghanrui
+     * @date 2024-08-01 11:08:23
+     * @protected
+     */
+    protected calcHidden(): void;
+    /**
+     * 获取当前表单数据
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 20:04:16
+     * @return {*}  {IData}
+     */
+    getData(): IData;
+    /**
+     * 重置表单数据
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 20:04:11
+     */
+    resetData(): void;
+    load(): Promise<IData>;
+    destroy(): void;
+    validate(): Promise<boolean>;
+    validateItem(_key: string): Promise<boolean>;
+    loaded(): void;
+    mounted(): void;
+}