@gct-paas/core-web 0.1.4-dev.9 → 0.1.5-dev.0

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,21 @@
+import { FormGroupState } from "../../state/form-group/form-group.state.mjs";
+import { FormItemBasicController } from "../form-item-basic/form-item-basic.controller.mjs";
+//#region src/modules/gct-form/controller/form-group/form-group.controller.ts
+/**
+* 表单分组控制器
+*
+* @author zhanghanrui
+* @date 2024-04-01 14:04:00
+* @export
+* @class FormGroupController
+* @extends {FormItemBasicController}
+* @implements {IFormGroupController}
+*/
+var FormGroupController = class extends FormItemBasicController {
+	type = "group";
+	crateItemState() {
+		return new FormGroupState();
+	}
+};
+//#endregion
+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,36 @@
+import { FormItemState } from "../../state/form-item/form-item.state.mjs";
+import { FormEditItemController } from "../form-edit-item/form-edit-item.controller.mjs";
+//#region src/modules/gct-form/controller/form-item/form-item.controller.ts
+/**
+* 表单项控制器
+*
+* @author zhanghanrui
+* @date 2024-04-02 20:04:03
+* @export
+* @class FormItemController
+* @extends {FormEditItemController}
+* @implements {IFormItemController}
+*/
+var FormItemController = class 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();
+	}
+};
+//#endregion
+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,64 @@
+import { FormItemBasicState } from "../../state/form-item-basic/form-item-basic.state.mjs";
+import { reactive } from "vue";
+//#region src/modules/gct-form/controller/form-item-basic/form-item-basic.controller.ts
+/**
+* 表单项基础控制器
+*
+* @author zhanghanrui
+* @date 2024-04-01 14:04:08
+* @export
+* @abstract
+* @class FormItemBasicController
+* @implements {IFormItemBasicController}
+*/
+var FormItemBasicController = class {
+	/**
+	* 表单项基础状态
+	*
+	* @description 禁止直接重写new实例，如果要覆盖重写 crateItemState 方法
+	* @author zhanghanrui
+	* @date 2024-04-02 22:04:07
+	* @type {IFormItemBasicState}
+	*/
+	state = this.crateItemState();
+	get data() {
+		return this.form.state.data;
+	}
+	/**
+	* 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();
+	}
+	init() {}
+	destroy() {
+		this.state.destroyed = true;
+	}
+	crateItemState() {
+		return new FormItemBasicState();
+	}
+};
+/**
+* 加载表单项控制器实例
+*
+* @author zhanghanrui
+* @date 2024-04-02 22:04:51
+* @export
+* @template T
+* @param {() => T} fn
+* @return {*}  {T}
+*/
+function useFormItemController(fn) {
+	const c = fn();
+	c.state = reactive(c.state);
+	return c;
+}
+//#endregion
+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,17 @@
+import { FormItemBasicController } from "../form-item-basic/form-item-basic.controller.mjs";
+//#region src/modules/gct-form/controller/form-item-hidden/form-item-hidden.controller.ts
+/**
+* 表单分组控制器
+*
+* @author zhanghanrui
+* @date 2024-04-01 14:04:00
+* @export
+* @class FormHiddenItemController
+* @extends {FormEditItemController}
+* @implements {IFormGroupController}
+*/
+var FormHiddenItemController = class extends FormItemBasicController {
+	type = "hidden";
+};
+//#endregion
+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,21 @@
+import { FormLineState } from "../../state/form-line/form-line.state.mjs";
+import { FormItemBasicController } from "../form-item-basic/form-item-basic.controller.mjs";
+//#region src/modules/gct-form/controller/form-line/form-line.controller.ts
+/**
+* 表单分组控制器
+*
+* @author zhanghanrui
+* @date 2024-04-01 14:04:00
+* @export
+* @class FormGroupController
+* @extends {FormItemBasicController}
+* @implements {IFormGroupController}
+*/
+var FormLineController = class extends FormItemBasicController {
+	type = "line";
+	crateItemState() {
+		return new FormLineState();
+	}
+};
+//#endregion
+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,21 @@
+import { FormTabState } from "../../state/form-tab/form-tab.state.mjs";
+import { FormItemBasicController } from "../form-item-basic/form-item-basic.controller.mjs";
+//#region src/modules/gct-form/controller/form-tab/form-tab.controller.ts
+/**
+* 表单分组控制器
+*
+* @author zhanghanrui
+* @date 2024-04-01 14:04:00
+* @export
+* @class FormTabController
+* @extends {FormItemBasicController}
+* @implements {IFormTabController}
+*/
+var FormTabController = class extends FormItemBasicController {
+	type = "tab";
+	crateItemState() {
+		return new FormTabState();
+	}
+};
+//#endregion
+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,21 @@
+import { FormTabPaneState } from "../../state/form-tab-pane/form-tab-pane.state.mjs";
+import { FormItemBasicController } from "../form-item-basic/form-item-basic.controller.mjs";
+//#region src/modules/gct-form/controller/form-tab-pane/form-tab-pane.controller.ts
+/**
+* 表单分组控制器
+*
+* @author zhanghanrui
+* @date 2024-04-01 14:04:00
+* @export
+* @class FormTabPaneController
+* @extends {FormItemBasicController}
+* @implements {IFormTabPaneController}
+*/
+var FormTabPaneController = class extends FormItemBasicController {
+	type = "tab-pane";
+	crateItemState() {
+		return new FormTabPaneState();
+	}
+};
+//#endregion
+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;
+}

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

@@ -0,0 +1,201 @@
+import { FormState } from "../../state/form/form.state.mjs";
+import { reactive } from "vue";
+import { QXEvent } from "qx-util";
+//#region src/modules/gct-form/controller/gct-form/gct-form.controller.ts
+/**
+* 表单控制器
+*
+* @author zhanghanrui
+* @date 2024-04-02 20:04:14
+* @export
+* @class GctFormController
+* @implements {IFormController}
+*/
+var GctFormController = class {
+	evt = new QXEvent();
+	state = reactive(new FormState());
+	item = {};
+	provider = {};
+	context = {};
+	params = {};
+	/**
+	* 所有属性的项标识，由 item 和 hidden 类型的表单项的 name 组成
+	*
+	* @author zhanghanrui
+	* @date 2024-04-02 20:04:20
+	* @protected
+	* @type {string[]}
+	*/
+	fields = [];
+	/**
+	* 所有[item、hidden]表单项的映射，key 为表单项的 name
+	*
+	* @author zhanghanrui
+	* @date 2024-04-02 20:04:39
+	* @protected
+	* @type {(Record<string, IFormItem | IFormHiddenItem>)}
+	*/
+	modelMap = {};
+	constructor(model) {
+		this.model = model;
+		this.init();
+	}
+	/**
+	* 表单初始化
+	*
+	* @author zhanghanrui
+	* @date 2024-04-01 13:04:27
+	* @protected
+	*/
+	init() {
+		if (this.model.children) this.initFormItems(this.model.children);
+		this.initEvent();
+		this.calcState();
+	}
+	/**
+	* 初始化表单事件订阅相关
+	*
+	* @author zhanghanrui
+	* @date 2024-04-02 14:04:31
+	* @protected
+	*/
+	initEvent() {}
+	/**
+	* 计算表单状态，数据变更或加载数据后调用
+	*
+	* @author zhanghanrui
+	* @date 2024-04-02 21:04:15
+	* @protected
+	*/
+	calcState() {}
+	/**
+	* 初始化表单项控制器
+	*
+	* @author zhanghanrui
+	* @date 2024-04-01 13:04:38
+	* @protected
+	* @param {IFormItemBasic[]} models
+	*/
+	initFormItems(models) {
+		models.forEach((model) => {
+			let provider = null;
+			if (model.type === "item" || model.type === "hidden") {
+				this.fields.push(model.name);
+				this.modelMap[model.name] = model;
+			}
+			if (model.type === "item") {
+				provider = _gct.register.formItem.create(`${model.type}___${model.editor.type}___${model.name}`);
+				if (!provider) provider = _gct.register.formItem.create(`${model.type}___${model.editor.type}`);
+			}
+			if (!provider) provider = _gct.register.formItem.create(model.type);
+			if (!provider) {
+				console.error(`未找到表单项提供者：${model.type}`, model);
+				return;
+			}
+			this.provider[model.name] = provider;
+			if (model.type === "item") {
+				const item = model;
+				this.item[item.name] = provider.createController(this, item);
+			} else if (model.type === "hidden") {
+				const hidden = model;
+				this.item[hidden.name] = provider.createController(this, hidden);
+			} else if (model.type === "container" || model.isContainer || model.container) {
+				const container = model;
+				this.item[model.name] = provider.createController(this, container);
+				if (container.children) this.initFormItems(container.children);
+			}
+		});
+	}
+	/**
+	* 计算表单项隐藏
+	*
+	* @author zhanghanrui
+	* @date 2024-08-01 11:08:23
+	* @protected
+	*/
+	calcHidden() {
+		Object.keys(this.item).forEach((key) => {
+			const c = this.item[key];
+			if (c.model.hidden) {
+				const bol = c.model.hidden(this, c, this.state.data);
+				if (bol != null) c.state.visible = !bol;
+			}
+		});
+	}
+	/**
+	* 获取当前表单数据
+	*
+	* @author zhanghanrui
+	* @date 2024-04-02 20:04:16
+	* @return {*}  {IData}
+	*/
+	getData() {
+		const data = {};
+		this.fields.forEach((field) => {
+			const c = this.item[field];
+			if (c && (c.state.visible === true || c.model.type === "hidden" || field.indexOf(".") !== -1)) setValue(c.value, c.key, data);
+		});
+		return data;
+	}
+	/**
+	* 重置表单数据
+	*
+	* @author zhanghanrui
+	* @date 2024-04-02 20:04:11
+	*/
+	resetData() {
+		this.fields.forEach((key) => {
+			const c = this.item[key];
+			if (c) c.reset();
+		});
+	}
+	async load() {
+		try {
+			if (!this.model.loadRequest) return {};
+			this.state.loading = true;
+			const data = await this.model.loadRequest({ id: this.context.id });
+			this.fields.forEach((key) => {
+				const c = this.item[key];
+				if (c) c.value = data[c.key];
+				c.defaultValue();
+			});
+			this.state.loaded = true;
+			return data;
+		} finally {
+			this.state.loading = false;
+		}
+	}
+	destroy() {
+		this.state.destroyed = true;
+		this.evt.reset();
+		this.fields.forEach((key) => {
+			const c = this.item[key];
+			if (c) c.destroy();
+		});
+	}
+	validate() {
+		return Promise.resolve(true);
+	}
+	validateItem(_key) {
+		return Promise.resolve(true);
+	}
+	loaded() {
+		this.calcHidden();
+		this.fields.forEach((key) => {
+			this.item[key].defaultValue();
+		});
+		this.calcState();
+	}
+	mounted() {}
+};
+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;
+		else if (!memo[cur]) memo[cur] = {};
+		return memo[cur];
+	}, data);
+}
+//#endregion
+export { GctFormController };