@kengic/vue 0.23.0 → 0.23.1

package/dist/src/components/KgSubmit/index.hooks.d.ts

@@ -1,8 +1,8 @@
 import { FormInstance } from 'ant-design-vue';
 import { ComputedRef, Ref } from 'vue';
 import { VarSubmitConfig, VarSubmitDetail } from '../../apis/WMS/models';
-import { IKgVarSubmitConfigProperties, IRemoveEventListenerHandler, KG__VAR_SUBMIT_CONFIG__DISPLAY_TYPE, KG_BUTTON_TYPE } from '../../consts';
-import { IKgSubmitAfterValidateCb, IKgSubmitBeforeOkCb, IKgSubmitBeforeOpenCb, IKgSubmitBeforeRequestCb, IKgSubmitCloseCb, IKgSubmitErrorCb, IKgSubmitOkCb, IKgSubmitOpenCb, IKgSubmitStore } from './index.store';
+import { IKgVarSubmitConfigProperties, IRemoveEventListenerHandler, KG__VAR_SUBMIT_CONFIG__DISPLAY_TYPE, KG__VAR_SUBMIT_CONFIG__LAYOUT, KG_BUTTON_TYPE, KG_WIDTH_UNIT } from '../../consts';
+import { IKgSubmitAfterValidateEventListener, IKgSubmitBeforeOkEventListener, IKgSubmitBeforeOpenEventListener, IKgSubmitBeforeRequestEventListener, IKgSubmitCloseEventListener, IKgSubmitErrorEventListener, IKgSubmitOkEventListener, IKgSubmitOpenEventListener, IKgSubmitStore } from './index.store';
 export interface IUseKgSubmit {
     /**
      * <p>「当前按钮」的「提交表单配置」.</p>
@@ -11,11 +11,15 @@ export interface IUseKgSubmit {
     /**
      * <p>「当前按钮」的「提交表单配置」的显示方式.</p>
      */
-    currentVarSubmitConfigDisplayType: ComputedRef<KG__VAR_SUBMIT_CONFIG__DISPLAY_TYPE>;
+    currentVarSubmitConfig$DisplayType: ComputedRef<KG__VAR_SUBMIT_CONFIG__DISPLAY_TYPE>;
+    /**
+     * <p>「当前按钮」的「提交表单配置」的布局.</p>
+     */
+    currentVarSubmitConfig$Layout: ComputedRef<KG__VAR_SUBMIT_CONFIG__LAYOUT>;
     /**
      * <p>「当前按钮」的「提交表单配置」的配置属性.</p>
      */
-    currentVarSubmitConfigProps: ComputedRef<IKgVarSubmitConfigProperties>;
+    currentVarSubmitConfig$Props: ComputedRef<IKgVarSubmitConfigProperties>;
     /**
      * <p>「当前按钮」的「提交表单字段」的所属分组(可见的).</p>
      */
@@ -48,10 +52,18 @@ export interface IUseKgSubmit {
      * 界面标识.
      */
     formID: string;
+    /**
+     * 表单数据对象.
+     */
+    formModel: ComputedRef<Record<string, any>>;
     /**
      * 表单组件.
      */
     formRef: Ref<FormInstance | null>;
+    /**
+     * 表单验证规则.
+     */
+    formRules: ReturnType<IKgSubmitStore['getFormRules']>;
     /**
      * <p>获取「提交表单配置」, 根据所传参数进行过滤.</p>
      *
@@ -108,6 +120,8 @@ export interface IUseKgSubmit {
     } | null): Array<VarSubmitDetail>;
     /**
      * 表单数据对象.
+     *
+     * @deprecated 请使用 {@link formModel}
      */
     model: ComputedRef<Record<string, any>>;
     /**
@@ -118,7 +132,7 @@ export interface IUseKgSubmit {
      * @param once 是否只会触发一次. 默认为 undefined.
      * @return {} 移除事件监听函数.
      */
-    onAfterValidate(cb: IKgSubmitAfterValidateCb, once?: boolean): IRemoveEventListenerHandler;
+    onAfterValidate(cb: IKgSubmitAfterValidateEventListener, once?: boolean): IRemoveEventListenerHandler;
     /**
      * <p>事件: 点击确认按钮之后, 执行默认逻辑之前.</p>
      * <ul>
@@ -131,14 +145,14 @@ export interface IUseKgSubmit {
      * @param once 是否只会触发一次. 默认为 undefined.
      * @return {} 移除事件监听函数.
      */
-    onBeforeOk(cb: IKgSubmitBeforeOkCb, once?: boolean): IRemoveEventListenerHandler;
+    onBeforeOk(cb: IKgSubmitBeforeOkEventListener, once?: boolean): IRemoveEventListenerHandler;
     /**
      * <p>事件: 打开提交弹窗之前.</p>
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      * @return {} 移除事件监听函数.
      */
-    onBeforeOpen(cb: IKgSubmitBeforeOpenCb, once?: boolean): IRemoveEventListenerHandler;
+    onBeforeOpen(cb: IKgSubmitBeforeOpenEventListener, once?: boolean): IRemoveEventListenerHandler;
     /**
      * <p>事件: 发起接口请求之前. 表单验证完成, 参数解析完成.</p>
      * <p>回调函数如果返回 true, 则不会再执行后面的代码.</p>
@@ -147,7 +161,7 @@ export interface IUseKgSubmit {
      * @param once 是否只会触发一次. 默认为 undefined.
      * @return {} 移除事件监听函数.
      */
-    onBeforeRequest(cb: IKgSubmitBeforeRequestCb, once?: boolean): IRemoveEventListenerHandler;
+    onBeforeRequest(cb: IKgSubmitBeforeRequestEventListener, once?: boolean): IRemoveEventListenerHandler;
     /**
      * <p>事件: 关闭提交弹窗. 下面几种场景都会触发此事件:</p>
      * <ul>
@@ -159,30 +173,31 @@ export interface IUseKgSubmit {
      * @param once 是否只会触发一次. 默认为 undefined.
      * @return {} 移除事件监听函数.
      */
-    onClose(cb: IKgSubmitCloseCb, once?: boolean): IRemoveEventListenerHandler;
+    onClose(cb: IKgSubmitCloseEventListener, once?: boolean): IRemoveEventListenerHandler;
     /**
      * <p>事件: 请求失败. 请求失败了, 或者请求返回了错误消息.</p>
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      * @return {} 移除事件监听函数.
      */
-    onError(cb: IKgSubmitErrorCb, once?: boolean): IRemoveEventListenerHandler;
+    onError(cb: IKgSubmitErrorEventListener, once?: boolean): IRemoveEventListenerHandler;
     /**
-     * <p>事件: 点击保存按钮之后, 执行默认逻辑之后, 调用接口成功, 即将关闭提交弹窗.</p>
+     * <p>事件: 点击保存按钮之后, 执行默认逻辑之后, 调用接口成功, 关闭提交弹窗之后.</p>
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      * @return {} 移除事件监听函数.
      */
-    onOk(cb: IKgSubmitOkCb, once?: boolean): IRemoveEventListenerHandler;
+    onOk(cb: IKgSubmitOkEventListener, once?: boolean): IRemoveEventListenerHandler;
     /**
      * <p>事件: 打开提交弹窗.</p>
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      * @return {} 移除事件监听函数.
      */
-    onOpen(cb: IKgSubmitOpenCb, once?: boolean): IRemoveEventListenerHandler;
+    onOpen(cb: IKgSubmitOpenEventListener, once?: boolean): IRemoveEventListenerHandler;
     /**
-     * 修改某个「提交表单字段」的部分属性.
+     * <p>修改某个「提交表单字段」的部分属性.</p>
+     * <p>如果参数 param.buttonType 和 param.buttonVarName 都为 undefined, 表示修改的是「当前按钮」的「提交表单字段」</p>
      *
      * @param param.buttonType <p>按钮的类型, 对应的是 {@link VarButton.typ} 属性, 取值请参考 {@link KG_BUTTON_TYPE}.</p>
      * @param param.buttonVarName <p>按钮的变量名称, 对应的是 {@link VarButton.var_nam} 属性.</p>
@@ -197,8 +212,26 @@ export interface IUseKgSubmit {
     }): void;
     /**
      * 表单验证规则.
+     *
+     * @deprecated 请使用 {@link formRules}.
+     */
+    rules: ReturnType<IKgSubmitStore['getFormRules']>;
+    /**
+     * <p>「查询按钮」的「提交表单配置」.</p>
+     */
+    searchVarSubmitConfig: ComputedRef<VarSubmitConfig | null>;
+    /**
+     * <p>「查询按钮」的「提交表单配置」的文本宽度.</p>
+     */
+    searchVarSubmitConfig$LabelColumn: ComputedRef<number>;
+    /**
+     * <p>「查询按钮」的「提交表单配置」的文本宽度单位.</p>
+     */
+    searchVarSubmitConfig$LabelColumnUnit: ComputedRef<KG_WIDTH_UNIT>;
+    /**
+     * <p>「查询按钮」的「提交表单配置」的布局.</p>
      */
-    rules: ReturnType<IKgSubmitStore['getRules']>;
+    searchVarSubmitConfig$Layout: ComputedRef<KG__VAR_SUBMIT_CONFIG__LAYOUT>;
     /**
      * 状态数据.
      */

package/dist/src/components/KgSubmit/index.store.d.ts

@@ -3,7 +3,7 @@ import { FormInstance } from 'ant-design-vue/lib/form/Form';
 import { StoreDefinition } from 'pinia';
 import { Ref } from 'vue';
 import { VarSubmitConfig, VarSubmitDetail } from '../../apis/WMS/models';
-import { IKgEventCb, KG_BUTTON_TYPE } from '../../consts';
+import { IKgEventListener, KG_BUTTON_TYPE } from '../../consts';
 import { KgAny } from '../../types';
 import { IKgTableRow } from '../KgTable';
 /**
@@ -13,33 +13,35 @@ import { IKgTableRow } from '../KgTable';
  *   'beforeOk':       点击确认按钮之后, 执行默认逻辑之前
  *   'afterValidate':  点击确认按钮之后, 表单验证完成,
  *   'beforeRequest':  发起接口请求之前. 表单验证完成, 参数解析完成,
- *   'ok':             请求成功, 即将关闭提交弹窗
+ *   'ok':             请求成功, 关闭提交弹窗之后
  *   'error':          请求失败. 请求失败了, 或者请求返回了错误消息
  *   'close':          关闭提交弹窗
  */
 export declare type IKgSubmitEvent = 'beforeOpen' | 'open' | 'beforeOk' | 'afterValidate' | 'beforeRequest' | 'ok' | 'error' | 'close';
-/** 事件监听函数: beforeOpen. */
-export declare type IKgSubmitBeforeOpenCbParam = {
+export declare type IKgSubmitBeforeOpenEventListenerParameter = {
     isCreating: boolean | null;
     isUpdating: boolean | null;
     isCopying: boolean | null;
     isDeleting: boolean | null;
     row: IKgTableRow | null;
 };
-export declare type IKgSubmitBeforeOpenCb = ((param: IKgSubmitBeforeOpenCbParam) => Promise<boolean>) & IKgEventCb;
-/** 事件监听函数: open. */
-export declare type IKgSubmitOpenCbParam = {
+export declare type IKgSubmitBeforeOpenEventListener = ((param: IKgSubmitBeforeOpenEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgSubmitOpenEventListenerParameter = {
+    /** @deprecated 请直接使用 {@link IUseKgVar.isCreating} */
     isCreating: boolean | null;
+    /** @deprecated 请直接使用 {@link IUseKgVar.isUpdating} */
     isUpdating: boolean | null;
+    /** @deprecated 请直接使用 {@link IUseKgVar.isCopying} */
     isCopying: boolean | null;
+    /** @deprecated 请直接使用 {@link IUseKgVar.isDeleting} */
     isDeleting: boolean | null;
-    /** 勾选的表格行. */
+    /** @deprecated 请直接使用 {@link IUseKgTable.selectedRow} */
     row: IKgTableRow | null;
+    /** @deprecated 请直接使用 {@link IUseKgSearch.formModel} */
     model: Ref<Record<string, any>>;
 };
-export declare type IKgSubmitOpenCb = ((param: IKgSubmitOpenCbParam) => Promise<boolean>) & IKgEventCb;
-/** 事件监听函数: beforeOk. */
-export declare type IKgSubmitBeforeOkCbParam = {
+export declare type IKgSubmitOpenEventListener = ((param: IKgSubmitOpenEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgSubmitBeforeOkEventListenerParameter = {
     isCopying: boolean | null;
     isCreating: boolean | null;
     isDeleting: boolean | null;
@@ -57,9 +59,8 @@ export declare type IKgSubmitBeforeOkCbParam = {
      */
     rules: Ref<Record<string, RuleObject[]>>;
 };
-export declare type IKgSubmitBeforeOkCb = ((param: IKgSubmitBeforeOkCbParam) => Promise<boolean>) & IKgEventCb;
-/** 事件监听函数: afterValidate. */
-export declare type IKgSubmitAfterValidateCbParam = {
+export declare type IKgSubmitBeforeOkEventListener = ((param: IKgSubmitBeforeOkEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgSubmitAfterValidateEventListenerParameter = {
     isCopying: boolean | null;
     isCreating: boolean | null;
     isDeleting: boolean | null;
@@ -68,9 +69,8 @@ export declare type IKgSubmitAfterValidateCbParam = {
     row: IKgTableRow | null;
     rows: Array<IKgTableRow> | null;
 };
-export declare type IKgSubmitAfterValidateCb = ((param: IKgSubmitAfterValidateCbParam) => Promise<boolean>) & IKgEventCb;
-/** 事件监听函数: beforeRequest. */
-export declare type IKgSubmitBeforeRequestCbParam = {
+export declare type IKgSubmitAfterValidateEventListener = ((param: IKgSubmitAfterValidateEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgSubmitBeforeRequestEventListenerParameter = {
     /**
      * <p>请求参数.</p>
      * <p>是一个对象或者列表.</p>
@@ -91,9 +91,8 @@ export declare type IKgSubmitBeforeRequestCbParam = {
     row: IKgTableRow | null;
     rows: Array<IKgTableRow> | null;
 };
-export declare type IKgSubmitBeforeRequestCb = ((param: IKgSubmitBeforeRequestCbParam) => Promise<boolean>) & IKgEventCb;
-/** 事件监听函数: ok. */
-export declare type IKgSubmitOkCbParam = {
+export declare type IKgSubmitBeforeRequestEventListener = ((param: IKgSubmitBeforeRequestEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgSubmitOkEventListenerParameter = {
     isCreating: boolean | null;
     isUpdating: boolean | null;
     isCopying: boolean | null;
@@ -103,37 +102,37 @@ export declare type IKgSubmitOkCbParam = {
     /** 接口返回结果. */
     result: any | null;
 };
-export declare type IKgSubmitOkCb = ((param: IKgSubmitOkCbParam) => Promise<boolean>) & IKgEventCb;
-/** 事件监听函数: error. */
-export declare type IKgSubmitErrorCb = ((param: any) => Promise<boolean>) & IKgEventCb;
-/** 事件监听函数: close. */
-export declare type IKgSubmitCloseCb = ((param?: any | null) => Promise<boolean>) & IKgEventCb;
-export declare type IKgSubmitCbParam = IKgSubmitBeforeOpenCbParam | IKgSubmitOpenCbParam | IKgSubmitBeforeOkCbParam | IKgSubmitAfterValidateCbParam | IKgSubmitBeforeRequestCbParam | IKgSubmitOkCbParam | null;
-export declare type IKgSubmitCb = IKgSubmitBeforeOpenCb | IKgSubmitOpenCb | IKgSubmitBeforeOkCb | IKgSubmitAfterValidateCb | IKgSubmitBeforeRequestCb | IKgSubmitOkCb | IKgSubmitErrorCb | IKgSubmitCloseCb;
+export declare type IKgSubmitOkEventListener = ((param: IKgSubmitOkEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgSubmitErrorEventListenerParameter = {};
+export declare type IKgSubmitErrorEventListener = ((param: IKgSubmitErrorEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgSubmitCloseEventListenerParameter = {} | null | undefined;
+export declare type IKgSubmitCloseEventListener = ((param: IKgSubmitCloseEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgSubmitEventListenerParameter = IKgSubmitBeforeOpenEventListenerParameter | IKgSubmitOpenEventListenerParameter | IKgSubmitBeforeOkEventListenerParameter | IKgSubmitAfterValidateEventListenerParameter | IKgSubmitBeforeRequestEventListenerParameter | IKgSubmitOkEventListenerParameter | IKgSubmitErrorEventListenerParameter | IKgSubmitCloseEventListenerParameter;
+export declare type IKgSubmitEventListener = IKgSubmitBeforeOpenEventListener | IKgSubmitOpenEventListener | IKgSubmitBeforeOkEventListener | IKgSubmitAfterValidateEventListener | IKgSubmitBeforeRequestEventListener | IKgSubmitOkEventListener | IKgSubmitErrorEventListener | IKgSubmitCloseEventListener;
 export interface IUseKgSubmitStoreState {
-    afterValidateListenersMap: Map<string, Array<IKgSubmitAfterValidateCb>>;
-    beforeOkListenersMap: Map<string, Array<IKgSubmitBeforeOkCb>>;
-    beforeOpenListenersMap: Map<string, Array<IKgSubmitBeforeOpenCb>>;
-    beforeRequestListenersMap: Map<string, Array<IKgSubmitBeforeRequestCb>>;
-    closeListenersMap: Map<string, Array<IKgSubmitCloseCb>>;
-    errorListenersMap: Map<string, Array<IKgSubmitErrorCb>>;
+    afterValidateEventListenersMap: Map<string, Array<IKgSubmitAfterValidateEventListener>>;
+    beforeOkEventListenersMap: Map<string, Array<IKgSubmitBeforeOkEventListener>>;
+    beforeOpenEventListenersMap: Map<string, Array<IKgSubmitBeforeOpenEventListener>>;
+    beforeRequestEventListenersMap: Map<string, Array<IKgSubmitBeforeRequestEventListener>>;
+    closeEventListenersMap: Map<string, Array<IKgSubmitCloseEventListener>>;
+    errorEventListenersMap: Map<string, Array<IKgSubmitErrorEventListener>>;
+    /** 表单数据对象. */
+    formModelMap: Map<string, Record<string, any>>;
     /** 表单对象. */
     formRefMap: Map<string, Ref<FormInstance | null>>;
-    isLoadingMap: Map<string, boolean>;
-    /** 表单数据对象. */
-    modelMap: Map<string, Record<string, any>>;
-    okListenersMap: Map<string, Array<IKgSubmitOkCb>>;
-    openListenersMap: Map<string, Array<IKgSubmitOpenCb>>;
     /**
      * <p>表单验证规则.</p>
      * <p>在 beforeOk 事件中会将此对象传给调用者, 调用者可以修改此对象, 从而添加自定义的验证规则.</p>
      */
-    rulesMap: Map<string, Ref<Record<string, Array<RuleObject>>>>;
+    formRulesMap: Map<string, Ref<Record<string, Array<RuleObject>>>>;
+    isLoadingMap: Map<string, boolean>;
+    okEventListenersMap: Map<string, Array<IKgSubmitOkEventListener>>;
+    openEventListenersMap: Map<string, Array<IKgSubmitOpenEventListener>>;
 }
 export interface IUseKgSubmitStoreGetters {
+    getFormModel(): (formID?: string | null) => Record<string, any> | null;
     getFormRef(): (formID?: string | null) => Ref<FormInstance | null>;
-    getModel(): (formID?: string | null) => Record<string, any> | null;
-    getRules(): (formID?: string | null) => Ref<Record<string, Array<RuleObject>>>;
+    getFormRules(): (formID?: string | null) => Ref<Record<string, Array<RuleObject>>>;
     getVarSubmitConfig(): (formID: string | null | undefined, param?: {
         buttonType?: KG_BUTTON_TYPE;
         buttonVarName?: string | null;
@@ -155,13 +154,13 @@ export interface IUseKgSubmitStoreActions {
      * @param event 事件名称.
      * @param cb 回调函数.
      */
-    addEventListener(formID: string, event: IKgSubmitEvent, cb: IKgSubmitCb): void;
+    addEventListener(formID: string, event: IKgSubmitEvent, cb: IKgSubmitEventListener): void;
     /**
      * 清理数据.
      * @param formID 页面标识.
      */
     dispose(formID?: string | null): void;
-    emit(formID: string, event: IKgSubmitEvent, param: IKgSubmitCbParam): Promise<boolean>;
+    emit<T = IKgSubmitEventListenerParameter>(formID: string, event: IKgSubmitEvent, param: T): Promise<boolean>;
     patchVarSubmitDetail(formID: string | null | undefined, param: {
         buttonType?: KG_BUTTON_TYPE;
         buttonVarName?: string | null;
@@ -174,9 +173,9 @@ export interface IUseKgSubmitStoreActions {
      * @param event 事件名称.
      * @param cb 回调函数.
      */
-    removeEventListener(formID: string, event: IKgSubmitEvent, cb?: IKgSubmitCb): void;
+    removeEventListener(formID: string, event: IKgSubmitEvent, cb?: IKgSubmitEventListener): void;
+    setFormModel(formID?: string | null, model?: Record<string, any> | null): void;
     setIsLoading(formID: string, value: boolean): void;
-    setModel(formID?: string | null, model?: Record<string, any> | null): void;
 }
 export declare type IUseKgSubmitStore = StoreDefinition<'KgSubmit', IUseKgSubmitStoreState, IUseKgSubmitStoreGetters, IUseKgSubmitStoreActions>;
 export declare type IKgSubmitStore = ReturnType<IUseKgSubmitStore>;

package/dist/src/components/KgSubmit/index.vm.d.ts

@@ -1,3 +1,4 @@
+import { KG__VAR_SUBMIT_CONFIG__LAYOUT } from '../../consts';
 /**
  * 表单的左边距.
  */
@@ -45,7 +46,7 @@ export declare const SUBMIT_DEFAULT_WIDTH: number;
 /**
  * 默认布局方式.
  */
-export declare const SUBMIT_DEFAULT_LAYOUT = "vertical";
+export declare const SUBMIT_DEFAULT_LAYOUT = KG__VAR_SUBMIT_CONFIG__LAYOUT.VERTICAL;
 /**
  * 单位为 SPAN 时, 文本的默认宽度.
  */

package/dist/src/components/KgTable/components/setting/KgTable.Setting.service.d.ts

@@ -11,4 +11,4 @@ export declare type IUseServices = {
 };
 export declare function _useServices(): IUseServices;
 /** 监控表格列的下拉列表的尺寸变化, 从而调整位置, 防止遮盖.  */
-export declare function _useObserveMenuColumns(isMenuItemColumnsVisible: Ref<boolean>): void;
+export declare function _useObserveMenuItemColumns(isMenuItemColumnsVisible: Ref<boolean>): void;

package/dist/src/components/KgTable/index.hooks.d.ts

@@ -1,6 +1,7 @@
 import { ComputedRef } from 'vue';
+import { VarGridConfig } from '../../apis/WMS/models';
 import { IRemoveEventListenerHandler } from '../../consts';
-import { IKgTableAfterRequestCb, IKgTableBeforeRequestCb, IKgTableBeforeSetDatasCb, IKgTableReadyCb, IKgTableRowDoubleClickCb, IKgTableStore } from './index.store';
+import { IKgTableAfterRequestEventListener, IKgTableBeforeParseParameterEventListener, IKgTableBeforeRequestEventListener, IKgTableBeforeSetDatasEventListener, IKgTableReadyEventListener, IKgTableRowDoubleClickEventListener, IKgTableStore } from './index.store';
 export interface IUseKgTable {
     /** 界面标识. */
     formID: string;
@@ -37,49 +38,63 @@ export interface IUseKgTable {
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onAfterSearch(cb: IKgTableAfterRequestCb, once?: boolean): IRemoveEventListenerHandler;
+    onAfterSearch(cb: IKgTableAfterRequestEventListener, once?: boolean): IRemoveEventListenerHandler;
+    /**
+     * 事件: 即将解析请求参数.
+     * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
+     */
+    onBeforeParseParameter(cb: IKgTableBeforeParseParameterEventListener, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 事件: 即将发起查询请求, 如果返回 true 表示不会发起请求.
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      * @deprecated 已废弃, 请使用 onBeforeSearch() 方法.
      */
-    onBeforeRetrieve(cb: IKgTableBeforeRequestCb, once?: boolean): IRemoveEventListenerHandler;
+    onBeforeRetrieve(cb: IKgTableBeforeRequestEventListener, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 事件: 即将发起查询请求, 如果返回 true 表示不会发起请求.
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onBeforeSearch(cb: IKgTableBeforeRequestCb, once?: boolean): IRemoveEventListenerHandler;
+    onBeforeSearch(cb: IKgTableBeforeRequestEventListener, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 事件: 查询请求成功, 表格数据尚未赋值. 此处可以对查询接口返回的列表数据作处理.
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onBeforeSetDatas(cb: IKgTableBeforeSetDatasCb, once?: boolean): IRemoveEventListenerHandler;
+    onBeforeSetDatas(cb: IKgTableBeforeSetDatasEventListener, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 事件: ready, 配置初始完成, 组件渲染完成.
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onReady(cb: IKgTableReadyCb, once?: boolean): IRemoveEventListenerHandler;
+    onReady(cb: IKgTableReadyEventListener, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 事件: 查询请求成功, 表格数据已经赋值, 表格状态已经更新.
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      * @deprecated 已废弃, 请使用 onAfterSearch() 方法.
      */
-    onRetrieve(cb: IKgTableAfterRequestCb, once?: boolean): IRemoveEventListenerHandler;
+    onRetrieve(cb: IKgTableAfterRequestEventListener, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 事件: 双击某行.
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onRowDoubleClick(cb: IKgTableRowDoubleClickCb, once?: boolean): IRemoveEventListenerHandler;
+    onRowDoubleClick(cb: IKgTableRowDoubleClickEventListener, once?: boolean): IRemoveEventListenerHandler;
     /** 当前分页选项. */
     pageSizeOption: ComputedRef<number>;
     /** 所有分页选项. */
     pageSizeOptions: ComputedRef<number[]>;
+    /**
+     * 修改「表格配置」的部分属性.
+     *
+     * @param param.properties 要修改的部分属性.
+     */
+    patchVarGridConfig(param: {
+        properties: VarGridConfig;
+    }): Promise<void>;
     /**
      * <p>查询参数.</p>
      * <p>此查询参数是最终传给后端接口的参数, 包含了查询条件, 还包含了表格中的排序和分页, 还包含了表格配置中的参数.</p>

package/dist/src/components/KgTable/index.store.d.ts

@@ -1,43 +1,46 @@
 import { Key } from 'ant-design-vue/lib/_util/type';
 import { StoreDefinition } from 'pinia';
 import { Ref } from 'vue';
-import { IPage } from '../../apis/WMS/models';
-import { IKgEventCb } from '../../consts';
+import { IPage, VarGridConfig } from '../../apis/WMS/models';
+import { IKgEventListener } from '../../consts';
 import { IKgTableRow, IKgTableRowHeight } from './index.vm';
 /**
  * 事件类型.
- *   'ready':          就绪, 配置初始完成, 组件渲染完成
- *   'rowDoubleClick': 双击某行
- *   'beforeSearch':   即将发起查询请求, 如果返回 true 表示不会发起请求
- *   'beforeSetDatas': 查询请求成功, 表格数据尚未赋值. 此处可以对查询接口返回的列表数据作处理
- *   'afterSearch':    查询请求成功, 表格数据已经赋值, 表格状态已经更新
+ *   'ready':                就绪, 配置初始完成, 组件渲染完成
+ *   'rowDoubleClick':       双击某行
+ *   'beforeParseParameter': 即将解析请求参数,
+ *   'beforeSearch':         即将发起查询请求, 如果返回 true 表示不会发起请求
+ *   'beforeSetDatas':       查询请求成功, 表格数据尚未赋值. 此处可以对查询接口返回的列表数据作处理
+ *   'afterSearch':          查询请求成功, 表格数据已经赋值, 表格状态已经更新
  */
-export declare type IKgTableEvent = 'ready' | 'rowDoubleClick' | 'beforeSearch' | 'beforeSetDatas' | 'afterSearch';
-/** 事件监听函数: ready. */
-export declare type IKgTableReadyParam = {};
-export declare type IKgTableReadyCb = ((param: IKgTableReadyParam) => Promise<boolean>) & IKgEventCb;
-/** 事件监听函数: rowDoubleClick. */
-export declare type IKgTableRowDoubleClickParam = {
+export declare type IKgTableEvent = 'ready' | 'rowDoubleClick' | 'beforeParseParameter' | 'beforeSearch' | 'beforeSetDatas' | 'afterSearch';
+export declare type IKgTableReadyEventListenerParameter = {};
+export declare type IKgTableReadyEventListener = ((param: IKgTableReadyEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgTableRowDoubleClickEventListenerParameter = {
     /** 双击的行. */
     row: IKgTableRow;
 };
-export declare type IKgTableRowDoubleClickCb = ((param: IKgTableRowDoubleClickParam) => Promise<boolean>) & IKgEventCb;
-/** 事件监听函数: beforeSearch. */
-export declare type IKgTableBeforeRequestCbParam = {
+export declare type IKgTableRowDoubleClickEventListener = ((param: IKgTableRowDoubleClickEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgTableBeforeParseParameterEventListenerParameter = {
+    /**
+     * 查询接口请求参数, 尚未解析.
+     */
+    params: Record<string, any>;
+};
+export declare type IKgTableBeforeParseParameterEventListener = ((param: IKgTableBeforeParseParameterEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgTableBeforeRequestEventListenerParameter = {
     /** 查询接口请求参数. */
     params: Record<string, any>;
     /** 查询接口返回的数据, 调用者可以直接修改该数据, 从而实现手动提供表格数据. */
     response: Ref;
 };
-export declare type IKgTableBeforeRequestCb = ((param: IKgTableBeforeRequestCbParam) => Promise<boolean>) & IKgEventCb;
-/** 事件监听函数: beforeSetDatas. */
-export declare type IKgTableBeforeSetDatasCbParam = {
+export declare type IKgTableBeforeRequestEventListener = ((param: IKgTableBeforeRequestEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgTableBeforeSetDatasEventListenerParameter = {
     /** 列表数据. */
     datas: Ref<Array<IKgTableRow>>;
 };
-export declare type IKgTableBeforeSetDatasCb = ((param: IKgTableBeforeSetDatasCbParam) => Promise<boolean>) & IKgEventCb;
-/** 事件监听函数: afterSearch. */
-export declare type IKgTableAfterRequestCbParam = {
+export declare type IKgTableBeforeSetDatasEventListener = ((param: IKgTableBeforeSetDatasEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgTableAfterRequestEventListenerParameter = {
     /** 查询接口请求参数. */
     params: Record<string, any>;
     /** 接口返回的分页数据. */
@@ -45,13 +48,14 @@ export declare type IKgTableAfterRequestCbParam = {
     /** 列表数据. */
     datas: Ref<Array<IKgTableRow>>;
 };
-export declare type IKgTableAfterRequestCb = ((param: IKgTableAfterRequestCbParam) => Promise<boolean>) & IKgEventCb;
-export declare type IKgTableCbParam = IKgTableReadyParam | IKgTableRowDoubleClickParam | IKgTableBeforeRequestCbParam | IKgTableBeforeSetDatasCbParam | IKgTableAfterRequestCbParam;
-export declare type IKgTableCb = IKgTableReadyCb | IKgTableRowDoubleClickCb | IKgTableBeforeRequestCb | IKgTableBeforeSetDatasCb | IKgTableAfterRequestCb;
+export declare type IKgTableAfterRequestEventListener = ((param: IKgTableAfterRequestEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgTableEventListenerParameter = IKgTableReadyEventListenerParameter | IKgTableRowDoubleClickEventListenerParameter | IKgTableBeforeParseParameterEventListenerParameter | IKgTableBeforeRequestEventListenerParameter | IKgTableBeforeSetDatasEventListenerParameter | IKgTableAfterRequestEventListenerParameter;
+export declare type IKgTableEventListener = IKgTableReadyEventListener | IKgTableRowDoubleClickEventListener | IKgTableBeforeParseParameterEventListener | IKgTableBeforeRequestEventListener | IKgTableBeforeSetDatasEventListener | IKgTableAfterRequestEventListener;
 export interface IUseKgTableStoreState {
-    afterRequestListenersMap: Map<string, Array<IKgTableAfterRequestCb>>;
-    beforeRequestListenersMap: Map<string, Array<IKgTableBeforeRequestCb>>;
-    beforeSetDatasListenersMap: Map<string, Array<IKgTableBeforeSetDatasCb>>;
+    afterRequestEventListenersMap: Map<string, Array<IKgTableAfterRequestEventListener>>;
+    beforeParseParameterEventListenersMap: Map<string, Array<IKgTableBeforeParseParameterEventListener>>;
+    beforeRequestEventListenersMap: Map<string, Array<IKgTableBeforeRequestEventListener>>;
+    beforeSetDatasEventListenersMap: Map<string, Array<IKgTableBeforeSetDatasEventListener>>;
     /** 列表数据. */
     datasMap: Map<String, Array<any>>;
     /** 是否就绪: 配置初始完成, 组件渲染完成. */
@@ -72,20 +76,20 @@ export interface IUseKgTableStoreState {
      *     <li>是: 所有描述列显示的是描述,</li>
      *     <li>否: 所有描述列显示的是原始的值,</li>
      * </ul>
-     * <p>描述列指的是显示类型为 {@link KG_TABLE_CELL_DISPLAY_TYPE.DESC} 的列.</p>
+     * <p>描述列指的是显示类型为 KG_TABLE_CELL_DISPLAY_TYPE.DESC 的列.</p>
      *
      * @default true
      */
     isShowDescriptionMap: Map<string, boolean>;
     /** 事件监听函数列表: ready. */
-    onReadyListenersMap: Map<string, Array<IKgTableReadyCb>>;
+    onReadyEventListenersMap: Map<string, Array<IKgTableReadyEventListener>>;
     /**
      * <p>查询参数.</p>
      * <p>此查询参数是最终传给后端接口的参数, 包含了查询条件, 还包含了表格中的排序和分页, 还包含了表格配置中的参数.</p>
      */
     requestParamsMap: Map<string, Record<string, any>>;
     /** '双击某行'事件监听函数列表. */
-    rowDoubleClickListenersMap: Map<string, Array<IKgTableRowDoubleClickCb>>;
+    rowDoubleClickEventListenersMap: Map<string, Array<IKgTableRowDoubleClickEventListener>>;
     /** 行高. */
     rowHeightMap: Map<string, IKgTableRowHeight>;
     /** 勾选的行的主键. */
@@ -134,7 +138,17 @@ export interface IUseKgTableStoreActions {
      * @param event 事件名称.
      * @param cb 回调函数.
      */
-    addEventListener(formID: string | null | undefined, event: IKgTableEvent, cb: IKgTableCb): void;
+    addEventListener(formID: string | null | undefined, event: IKgTableEvent, cb: IKgTableEventListener): void;
+    /**
+     * 修改「表格配置」的部分属性.
+     *
+     * @param formID 界面标识.
+     * @param param 其他参数.
+     * @param param.properties 要修改的部分属性.
+     */
+    patchVarGridConfig(formID: string, param: {
+        properties: VarGridConfig;
+    }): Promise<void>;
     /**
      * 清空表格数据.
      * @param formID 界面标识.
@@ -151,7 +165,7 @@ export interface IUseKgTableStoreActions {
      * @param event 事件名称.
      * @param param 数据.
      */
-    emit<T = IKgTableCbParam>(formID: string | null | undefined, event: IKgTableEvent, param: T): Promise<boolean>;
+    emit<T = IKgTableEventListenerParameter>(formID: string | null | undefined, event: IKgTableEvent, param: T): Promise<boolean>;
     /**
      * 刷新勾选的行. 表格列表数据变更之后, 需要同步到勾选的行.
      * @param frmId 界面标识.
@@ -163,7 +177,7 @@ export interface IUseKgTableStoreActions {
      * @param event 事件名称.
      * @param cb 回调函数.
      */
-    removeEventListener(formID: string | null | undefined, event: IKgTableEvent, cb?: IKgTableCb): void;
+    removeEventListener(formID: string | null | undefined, event: IKgTableEvent, cb?: IKgTableEventListener): void;
     /**
      * 设置列表数据.
      * @param param.frmId 界面标识.

package/dist/src/components/KgTable/index.vm.d.ts

@@ -9,7 +9,7 @@ export declare type IKgTableRow = {
     [index: string]: any;
 };
 /** 查询方法参数. */
-export interface IKgTableRequestParams {
+export interface IKgTableRequestParameter {
     /**
      * 是否查询首页, 否则查询当页.
      *