@kengic/vue 0.23.1 → 0.23.3-beta.0

package/dist/src/utils/kg.util.d.ts

@@ -30,38 +30,17 @@ export declare class KgUtil {
     static downloadFile(data: string | BlobPart, fileName: string, contentType?: string): void;
     /**
      * <p>处理请求参数.</p>
+     * <ul>
+     *     <li>删除无用属性,</li>
+     *     <li>日期转换为字符串,</li>
+     *     <li>解析动态属性, 比如 {WAREHOUSE},</li>
+     * </ul>
+     *
      * @param params 请求参数.
      * @param formID 界面标识.
      * @param $dayjs dayjs.
      */
     static parseParams(params: Record<string, any> | null | undefined, formID?: string | null, $dayjs?: typeof dayjs): Record<string, any>;
-    /**
-     * <p>获取根据查询条件拼接后的 SQL 语句片段.</p>
-     * <p>根据查询参数拼接为一个 SQL 片段, 格式如下: `WHERE ... ORDER BY ...`.</p>
-     * <p>
-     *     参数 formID 和 operators 只能其中一个传值.
-     *     <ul>
-     *         <li>如果 formID 传值, 表示通过变量配置获取各个字段的高级查询操作符.</li>
-     *         <li>如果 operators 传值, 表示直接使用传入的 operators 作为各个字段的高级查询操作符.</li>
-     *     </ul>
-     * </p>
-     *
-     * @param param.params 请求参数.
-     * @param param.formID 界面标识.
-     * @param param.operators 各个字段的高级查询操作符.
-     * @param param.$dayjs dayjs.
-     */
-    static getQueryHeaders(param: {
-        $dayjs: typeof dayjs;
-        formID: string | null | undefined;
-        operators: Record<string, any> | null | undefined;
-        params: Record<string, any> | null | undefined;
-    }): {
-        operatorJSON: string;
-        orderBySql: string;
-        sql: string;
-        whereSql: string;
-    };
     /**
      * 处理请求参数: 解析字符串类型的参数值.
      *
@@ -76,15 +55,20 @@ export declare class KgUtil {
      *
      * @param value 参数的原始值.
      */
-    private static parseParamFromString;
+    static parseParamFromString(value: string): string;
     /**
-     * 处理请求参数: 解析 DayJS 类型的参数值.
-     * @param param.key 属性名.
-     * @param param.value 参数的原始值.
+     * 处理请求参数: 解析 Dayjs 类型的参数值.
      * @param param.formID 界面标识.
      * @param param.isPad 是否补齐日期格式. 即将 `YYYY-MM-DD` 补齐为 `YYYY-MM-DD 00:00:00`, 将 `HH:mm:ss` 补齐为 `1900-01-01 HH:mm:ss`.
+     * @param param.key 属性名.
+     * @param param.value 参数的原始值.
      */
-    private static parseParamFromDayJS;
+    static parseParamFromDayjs(param: {
+        formID?: string | null;
+        isPad?: boolean;
+        key: string;
+        value: any;
+    }): string;
     /**
      * 确认弹窗.
      * 设置了多个属性的默认值, 简化使用.
@@ -93,11 +77,30 @@ export declare class KgUtil {
      */
     static confirm(props: IKgVarButtonModalProperties): ModalFunc;
     /**
-     * 如果此错误不是表单验证错误, 则抛出此错误.
-     *
-     * @param e 错误对象.
+     * @deprecated 已弃用, 请使用 {@link KgUtil.throwNotFormValidationError()} 方法.
      */
     static throwIfNotFormError(e: any): void;
+    /**
+     * <p>如果不是表单验证错误, 则直接抛出该错误.</p>
+     * <p>如果是表单验证错误, 则弹框提示表单验证失败消息.</p>
+     *
+     * @param param.error 错误对象.
+     * @param param.formID 界面标识. 通过界面标识可以显示对应字段的翻译, 否则只能显示对应字段的变量名称.
+     * @param param.isShowFormValidationErrorMessage 是否弹框提示表单验证失败消息. 默认为 true.
+     */
+    static throwNotFormValidationError(param: {
+        error: {
+            errorFields: Array<{
+                errors: Array<string>;
+                name: Array<string>;
+                warnings: Array<any>;
+            }>;
+            outOfDate: boolean;
+            values: Record<string, any>;
+        } | any;
+        formID?: string;
+        isShowFormValidationErrorMessage?: boolean;
+    }): void;
     /**
      * 将 JSON 字符串转换为 JSON 对象, 如果转化失败, 则返回空对象.
      * @param str JSON 字符串.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kengic/vue",
-    "version": "0.23.1",
+    "version": "0.23.3-beta.0",
     "scripts": {
         "build": "npm run switch-node-version && rimraf dist && vue-tsc && vite build",
         "build:dev": "npm run switch-node-version && rimraf dist && vue-tsc && vite build --mode development",