vap1 0.4.5 → 0.5.0

package/utils/Ajax.js

@@ -20,8 +20,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
     function verb(n) { return function (v) { return step([n, v]); }; }
     function step(op) {
         if (f) throw new TypeError("Generator is already executing.");
@@ -105,16 +105,13 @@ exports.CATCH = CATCH;
  * 当满足不了需求时，可使用 `FETCH`，参考与标准 fetch 类似。
 */
 var FETCH = function (url, options) { return __awaiter(void 0, void 0, void 0, function () {
-    var fetchOptions, response, result;
+    var fetchOptions, response, result_1, result;
     return __generator(this, function (_a) {
         switch (_a.label) {
             case 0:
                 if (options.process !== false)
                     start();
-                fetchOptions = lodash_1.default.merge({
-                    method: 'GET',
-                    headers: Global_1.CONFIG.AJAX.headers,
-                }, options);
+                fetchOptions = lodash_1.default.merge({ method: 'GET', headers: Global_1.CONFIG.AJAX.headers, }, options);
                 if (fetchOptions.body && lodash_1.default.isPlainObject(fetchOptions.body)) {
                     fetchOptions.body = JSON.stringify(fetchOptions.body);
                 }
@@ -123,17 +120,23 @@ var FETCH = function (url, options) { return __awaiter(void 0, void 0, void 0, f
                 response = _a.sent();
                 if (options.process !== false)
                     done();
+                if (!lodash_1.default.isFunction(Global_1.CONFIG.AJAX.beforeReceive)) return [3 /*break*/, 3];
+                return [4 /*yield*/, Global_1.CONFIG.AJAX.beforeReceive(response, url, fetchOptions)];
+            case 2:
+                result_1 = _a.sent();
+                return [2 /*return*/, result_1];
+            case 3:
                 if (response.redirected && lodash_1.default.isString(response.url) && response.url.indexOf('login') >= 0) {
                     if (window.location.href.indexOf('login') < 0) {
                         window.location.href = response.url;
                         return [2 /*return*/, new Promise(function (r) { return r({ code: '9999', message: '请先登录' }); })];
                     }
                 }
-                if (!fetchOptions.text) return [3 /*break*/, 3];
+                if (!fetchOptions.text) return [3 /*break*/, 5];
                 return [4 /*yield*/, response.text()];
-            case 2: return [2 /*return*/, _a.sent()];
-            case 3: return [4 /*yield*/, response.json()];
-            case 4:
+            case 4: return [2 /*return*/, _a.sent()];
+            case 5: return [4 /*yield*/, response.json()];
+            case 6:
                 result = _a.sent();
                 return [2 /*return*/, result];
         }
@@ -155,6 +158,7 @@ var GET = function (url, options) { return __awaiter(void 0, void 0, void 0, fun
         switch (_b.label) {
             case 0:
                 _a = __read([_AjaxUtil_1.CACHE_URL.has(url), _AjaxUtil_1.CACHE_TIMER.get(url)], 2), isCache = _a[0], timer = _a[1];
+                if (!!Global_1.CONFIG.AJAX.disableCache) return [3 /*break*/, 2];
                 useCache = false;
                 if (isCache && sessionStorage.getItem(url)) {
                     useCache = true;
@@ -184,11 +188,13 @@ var GET = function (url, options) { return __awaiter(void 0, void 0, void 0, fun
             case 2: return [4 /*yield*/, _FETCH('GET', url, {}, options)];
             case 3:
                 resp = _b.sent();
-                if (_AjaxUtil_1.CACHE_URL.has(url)) {
-                    if (lodash_1.default.has(resp, 'code') && resp.code == '0') {
-                        sessionStorage.setItem(url, JSON.stringify(resp));
-                        if (timer) {
-                            sessionStorage.setItem(url + TIMER_SUFFIX, Date.now() + '');
+                if (!Global_1.CONFIG.AJAX.disableCache) {
+                    if (_AjaxUtil_1.CACHE_URL.has(url)) {
+                        if (lodash_1.default.has(resp, 'code') && resp.code == '0') {
+                            sessionStorage.setItem(url, JSON.stringify(resp));
+                            if (timer) {
+                                sessionStorage.setItem(url + TIMER_SUFFIX, Date.now() + '');
+                            }
                         }
                     }
                 }

package/utils/CacheUtil.d.ts

@@ -2,7 +2,7 @@ export declare const set: (key: string, value: any) => void;
 /**
  * 获取 Session 缓存， 并以 Object 返回 （JSON）
 */
-export declare const getData: <T extends object = any>(key: string, defaultValue?: T) => any;
+export declare const getData: <T extends object = any>(key: string, defaultValue?: T) => T | any;
 /**
  * 获取 Session 缓存， 并以 String 返回
 */

package/utils/Const.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DO_NOT_SHOW_PROCESS = exports.DATE_FORMAT = exports.NONE = void 0;
 var react_1 = __importStar(require("react"));

package/utils/Format.d.ts

@@ -1,35 +1,159 @@
 /**
- * string representing a number in fixed-point notation.
- * Number of digits after the decimal point. Must be in the range 0 - 20, inclusive.
+ * 小数位数参数的类型定义，用于数字格式化函数
+ * 定义了小数点后有效位数，或者布尔标志
  */
 export type FractionDigits = boolean | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19;
+/**
+ * getFormater函数使用的数字格式选项类型定义
+ */
 export type NumberFormat = 'int' | 'int-fixed' | 'number' | 'size' | 'usd' | 'chinese' | 'percent';
 /**
- * 123456 -> '123,456'
- * 1234567 -> '1,234,567'
-*/
+ * 使用美元格式（逗号分隔符）格式化数字
+ *
+ * @param num - 要格式化的数字
+ * @param digital - 显示的小数位数（如果为false或0，则显示整数）
+ * @returns 带千位分隔符的格式化字符串
+ *
+ * @example
+ * formatUSD(123456) => '123,456'
+ * formatUSD(1234567, 2) => '1,234,567.00'
+ */
 export declare const formatUSD: (num: number, digital?: FractionDigits) => string;
 /**
- * num: 分子，需要格式化的数字
- * base: 分母,默认为 1
- *          formatPercent(0.2, 1) = 20%
- *          formatPercent(20, 100) = 20%
- * fractionDigits: 小数点位数，默认为2
-*/
+ * 将数字格式化为百分比
+ *
+ * @param num - 分子（要格式化的数字）
+ * @param basic - 分母（默认为1）
+ * @param fractionDigits - 显示的小数位数（默认为2）
+ * @returns 带%符号的格式化百分比字符串
+ *
+ * @example
+ * formatPercent(0.2, 1) => '20%'
+ * formatPercent(20, 100) => '20%'
+ * formatPercent(0.255, 1, 1) => '25.5%'
+ */
 export declare const formatPercent: (num: number, basic?: number, fractionDigits?: FractionDigits) => string;
+/**
+ * 将字节大小格式化为人类可读的格式并附带适当的单位
+ *
+ * @param byteSize - 字节大小
+ * @returns 带有适当单位的格式化字符串（b, KB, MB, GB, TB, PB）
+ *
+ * @example
+ * formatSize(1500) => '1.46KB'
+ * formatSize(1500000) => '1.43MB'
+ */
 export declare const formatSize: (byteSize: number) => string;
 /**
- * pos ： 小数点后面位数,最多20
-*/
+ * 将数字格式化为指定小数位数
+ *
+ * @param num - 要格式化的数字
+ * @param fractionDigits - 小数位数（默认为2）
+ * @returns 格式化后的数字字符串
+ *
+ * @example
+ * formatNumber(123.456, 2) => '123.46'
+ * formatNumber(123.456, 0) => '123'
+ */
 export declare const formatNumber: (num: number, fractionDigits?: FractionDigits) => string;
+/**
+ * 将数字格式化为整数（四舍五入）
+ *
+ * @param num - 要格式化的数字
+ * @param returnString - 是否将结果作为字符串返回（默认为false）
+ * @returns 根据returnString参数返回四舍五入的整数或字符串
+ *
+ * @example
+ * formatInt(123.6) => 124
+ * formatInt(123.6, true) => '124'
+ */
 export declare function formatInt(num: number): number;
 export declare function formatInt(num: number, returnString: false): number;
 export declare function formatInt(num: number, returnString: true): string;
+/**
+ * 将数字格式化为固定长度的整数，前面补零
+ *
+ * @param num - 要格式化的数字
+ * @param fractionDigits - 期望的字符串长度（默认为5）
+ * @returns 带前导零的固定长度字符串
+ *
+ * @example
+ * formatIntFixed(123, 5) => '00123'
+ * formatIntFixed(1234, 3) => '1234' （超出限制，返回完整数字）
+ */
 export declare const formatIntFixed: (num: number, fractionDigits?: FractionDigits) => string;
+/**
+ * 使用中文数字单位（万、亿）格式化数字
+ *
+ * @param num - 要格式化的数字
+ * @param digital - 小数位数（默认为2）
+ * @returns 带中文单位的格式化字符串
+ *
+ * @example
+ * formatChinese(12345) => '1.23万'
+ * formatChinese(123456789) => '1.23亿'
+ */
 export declare const formatChinese: (num: number, digital?: boolean | FractionDigits) => string;
-export declare const getFormater: (type: NumberFormat, fix?: FractionDigits) => (num: number) => string;
+/**
+ * 根据指定的数字格式类型返回格式化函数
+ *
+ * @param type - 数字格式类型
+ * @param fix - 小数位数（可选）
+ * @returns 按照指定类型格式化数字的函数
+ *
+ * @example
+ * const formatter = getFormater('usd');
+ * formatter(12345) => '12,345'
+ */
+export declare const getFormater: (type: NumberFormat, fix?: FractionDigits) => ((num: number) => string);
+/**
+ * 将日期字符串或时间戳格式化为YYYY-MM-DD
+ *
+ * @param str - 日期字符串或时间戳
+ * @returns 格式化的日期字符串，无效则返回空字符串
+ *
+ * @example
+ * formatDate('2023-01-15T12:30:45') => '2023-01-15'
+ */
 export declare const formatDate: (str: string | number) => string;
+/**
+ * 将日期字符串或时间戳格式化为YYYY-MM-DD HH:mm:ss
+ *
+ * @param str - 日期字符串或时间戳
+ * @returns 格式化的日期时间字符串，无效则返回空字符串
+ *
+ * @example
+ * formatDateTime('2023-01-15T12:30:45') => '2023-01-15 12:30:45'
+ */
 export declare const formatDateTime: (str: string | number) => string;
+/**
+ * 对身份证号码进行隐私保护处理
+ *
+ * @param str - 身份证号码字符串
+ * @returns 中间部分被隐藏的身份证号码
+ *
+ * @example
+ * maskIdCard('123456789012345678') => '12345*******678'
+ */
 export declare const maskIdCard: (str: string) => string;
+/**
+ * 对电话号码进行隐私保护处理
+ *
+ * @param str - 电话号码字符串
+ * @returns 中间部分被隐藏的电话号码
+ *
+ * @example
+ * maskPhone('1234567890') => '123****7890'
+ * maskPhone('123-4567890') => '123***890'
+ */
 export declare const maskPhone: (str: string) => string;
+/**
+ * 对电子邮件地址进行隐私保护处理
+ *
+ * @param str - 电子邮件地址字符串
+ * @returns 账户部分和域名部分被部分隐藏的电子邮件
+ *
+ * @example
+ * maskEmail('user@example.com') => 'us*********@***********.com'
+ */
 export declare const maskEmail: (str: string) => string;

package/utils/Format.js

@@ -19,11 +19,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.maskEmail = exports.maskPhone = exports.maskIdCard = exports.formatDateTime = exports.formatDate = exports.getFormater = exports.formatChinese = exports.formatIntFixed = exports.formatInt = exports.formatNumber = exports.formatSize = exports.formatPercent = exports.formatUSD = void 0;
+exports.maskEmail = exports.maskPhone = exports.maskIdCard = exports.formatDateTime = exports.formatDate = exports.getFormater = exports.formatChinese = exports.formatIntFixed = exports.formatNumber = exports.formatSize = exports.formatPercent = exports.formatUSD = void 0;
+exports.formatInt = formatInt;
 var lodash_1 = __importDefault(require("lodash"));
 var Const_1 = require("./Const");
 var StringUtil_1 = require("./StringUtil");
 var dayjs_1 = __importDefault(require("dayjs"));
+/**
+ * 定点数格式化的最大值数组
+ * 用于限制formatIntFixed函数中数字的上限
+ */
 var MAX_FIX = [
     0,
     9,
@@ -43,9 +48,16 @@ var MAX_FIX = [
     999999999999999
 ];
 /**
- * 123456 -> '123,456'
- * 1234567 -> '1,234,567'
-*/
+ * 使用美元格式（逗号分隔符）格式化数字
+ *
+ * @param num - 要格式化的数字
+ * @param digital - 显示的小数位数（如果为false或0，则显示整数）
+ * @returns 带千位分隔符的格式化字符串
+ *
+ * @example
+ * formatUSD(123456) => '123,456'
+ * formatUSD(1234567, 2) => '1,234,567.00'
+ */
 var formatUSD = function (num, digital) {
     if (digital === void 0) { digital = false; }
     if (digital == false || digital == 0)
@@ -55,45 +67,64 @@ var formatUSD = function (num, digital) {
 };
 exports.formatUSD = formatUSD;
 /**
- * num: 分子，需要格式化的数字
- * base: 分母,默认为 1
- *          formatPercent(0.2, 1) = 20%
- *          formatPercent(20, 100) = 20%
- * fractionDigits: 小数点位数，默认为2
-*/
+ * 将数字格式化为百分比
+ *
+ * @param num - 分子（要格式化的数字）
+ * @param basic - 分母（默认为1）
+ * @param fractionDigits - 显示的小数位数（默认为2）
+ * @returns 带%符号的格式化百分比字符串
+ *
+ * @example
+ * formatPercent(0.2, 1) => '20%'
+ * formatPercent(20, 100) => '20%'
+ * formatPercent(0.255, 1, 1) => '25.5%'
+ */
 var formatPercent = function (num, basic, fractionDigits) {
     if (basic === void 0) { basic = 1; }
     if (fractionDigits === void 0) { fractionDigits = 2; }
     return (0, exports.formatNumber)(num * 100 / basic, fractionDigits) + '%';
 };
 exports.formatPercent = formatPercent;
+/**
+ * 将字节大小格式化为人类可读的格式并附带适当的单位
+ *
+ * @param byteSize - 字节大小
+ * @returns 带有适当单位的格式化字符串（b, KB, MB, GB, TB, PB）
+ *
+ * @example
+ * formatSize(1500) => '1.46KB'
+ * formatSize(1500000) => '1.43MB'
+ */
 var formatSize = function (byteSize) {
-    if (byteSize < 1024) {
+    if (byteSize < 1024)
         return (0, exports.formatNumber)(byteSize) + 'b';
-    }
     var kbSize = (byteSize / 1024);
-    if (kbSize < 1024) {
+    if (kbSize < 1024)
         return (0, exports.formatNumber)(kbSize) + 'KB';
-    }
     var mbSize = (kbSize / 1024);
-    if (mbSize < 1024) {
+    if (mbSize < 1024)
         return (0, exports.formatNumber)(mbSize) + 'MB';
-    }
     var gbSize = (mbSize / 1024);
-    if (gbSize < 1024) {
+    if (gbSize < 1024)
         return (0, exports.formatNumber)(gbSize) + 'GB';
-    }
     var tbSize = (gbSize / 1024);
-    if (tbSize < 1024) {
+    if (tbSize < 1024)
         return (0, exports.formatNumber)(tbSize) + 'TB';
-    }
     var pbSize = (tbSize / 1024);
     return (0, exports.formatNumber)(pbSize) + 'PB';
 };
 exports.formatSize = formatSize;
 /**
- * pos ： 小数点后面位数,最多20
-*/
+ * 将数字格式化为指定小数位数
+ *
+ * @param num - 要格式化的数字
+ * @param fractionDigits - 小数位数（默认为2）
+ * @returns 格式化后的数字字符串
+ *
+ * @example
+ * formatNumber(123.456, 2) => '123.46'
+ * formatNumber(123.456, 0) => '123'
+ */
 var formatNumber = function (num, fractionDigits) {
     if (fractionDigits === void 0) { fractionDigits = 2; }
     if (fractionDigits == false || fractionDigits == 0)
@@ -109,7 +140,17 @@ function formatInt(num, returnString) {
     }
     return result;
 }
-exports.formatInt = formatInt;
+/**
+ * 将数字格式化为固定长度的整数，前面补零
+ *
+ * @param num - 要格式化的数字
+ * @param fractionDigits - 期望的字符串长度（默认为5）
+ * @returns 带前导零的固定长度字符串
+ *
+ * @example
+ * formatIntFixed(123, 5) => '00123'
+ * formatIntFixed(1234, 3) => '1234' （超出限制，返回完整数字）
+ */
 var formatIntFixed = function (num, fractionDigits) {
     if (fractionDigits === void 0) { fractionDigits = 5; }
     var pos = lodash_1.default.isNumber(fractionDigits) ? fractionDigits : 5;
@@ -125,6 +166,17 @@ var formatIntFixed = function (num, fractionDigits) {
     return prefix + val;
 };
 exports.formatIntFixed = formatIntFixed;
+/**
+ * 使用中文数字单位（万、亿）格式化数字
+ *
+ * @param num - 要格式化的数字
+ * @param digital - 小数位数（默认为2）
+ * @returns 带中文单位的格式化字符串
+ *
+ * @example
+ * formatChinese(12345) => '1.23万'
+ * formatChinese(123456789) => '1.23亿'
+ */
 var formatChinese = function (num, digital) {
     if (digital === void 0) { digital = 2; }
     var result;
@@ -152,6 +204,17 @@ var formatChinese = function (num, digital) {
     return result + unit;
 };
 exports.formatChinese = formatChinese;
+/**
+ * 根据指定的数字格式类型返回格式化函数
+ *
+ * @param type - 数字格式类型
+ * @param fix - 小数位数（可选）
+ * @returns 按照指定类型格式化数字的函数
+ *
+ * @example
+ * const formatter = getFormater('usd');
+ * formatter(12345) => '12,345'
+ */
 var getFormater = function (type, fix) {
     switch (type) {
         case 'number':
@@ -178,6 +241,15 @@ var getFormater = function (type, fix) {
     }
 };
 exports.getFormater = getFormater;
+/**
+ * 将日期字符串或时间戳格式化为YYYY-MM-DD
+ *
+ * @param str - 日期字符串或时间戳
+ * @returns 格式化的日期字符串，无效则返回空字符串
+ *
+ * @example
+ * formatDate('2023-01-15T12:30:45') => '2023-01-15'
+ */
 var formatDate = function (str) {
     var date = (0, dayjs_1.default)(str);
     if (date.isValid())
@@ -185,6 +257,15 @@ var formatDate = function (str) {
     return '';
 };
 exports.formatDate = formatDate;
+/**
+ * 将日期字符串或时间戳格式化为YYYY-MM-DD HH:mm:ss
+ *
+ * @param str - 日期字符串或时间戳
+ * @returns 格式化的日期时间字符串，无效则返回空字符串
+ *
+ * @example
+ * formatDateTime('2023-01-15T12:30:45') => '2023-01-15 12:30:45'
+ */
 var formatDateTime = function (str) {
     var date = (0, dayjs_1.default)(str);
     if (date.isValid())
@@ -192,6 +273,15 @@ var formatDateTime = function (str) {
     return '';
 };
 exports.formatDateTime = formatDateTime;
+/**
+ * 对身份证号码进行隐私保护处理
+ *
+ * @param str - 身份证号码字符串
+ * @returns 中间部分被隐藏的身份证号码
+ *
+ * @example
+ * maskIdCard('123456789012345678') => '12345*******678'
+ */
 var maskIdCard = function (str) {
     if (!lodash_1.default.isString(str) || str == null)
         return '';
@@ -200,6 +290,16 @@ var maskIdCard = function (str) {
     return str.substring(0, 5) + '*******' + str.substring(str.length - 3);
 };
 exports.maskIdCard = maskIdCard;
+/**
+ * 对电话号码进行隐私保护处理
+ *
+ * @param str - 电话号码字符串
+ * @returns 中间部分被隐藏的电话号码
+ *
+ * @example
+ * maskPhone('1234567890') => '123****7890'
+ * maskPhone('123-4567890') => '123***890'
+ */
 var maskPhone = function (str) {
     if (!lodash_1.default.isString(str) || str == null)
         return '';
@@ -211,6 +311,15 @@ var maskPhone = function (str) {
     return str.substring(0, 3) + '****' + str.substring(str.length - 4);
 };
 exports.maskPhone = maskPhone;
+/**
+ * 对电子邮件地址进行隐私保护处理
+ *
+ * @param str - 电子邮件地址字符串
+ * @returns 账户部分和域名部分被部分隐藏的电子邮件
+ *
+ * @example
+ * maskEmail('user@example.com') => 'us*********@***********.com'
+ */
 var maskEmail = function (str) {
     if (!lodash_1.default.isString(str) || str == null)
         return '';

package/utils/Global.d.ts

@@ -1,5 +1,5 @@
 import { Language } from './_Support';
-import type { PlainObject } from '../basetype';
+import type { PlainObject, BaseOption } from '../basetype';
 import type { TableSize } from 'antd/es/table';
 /**
  * 全局定义
@@ -88,9 +88,30 @@ export type GlobalSetting = {
         data: string;
     };
     AJAX: {
+        /**
+         * 是否禁用缓存，默认false
+         * 设置为 true 后，Ajax.GET 将不进行缓存判断
+         * 说明: VAP 内置此功能，使用 /XX/?__DISABLE_CACHE=1 可禁用
+        */
+        disableCache: boolean;
+        /**
+         * Ajax 超时时间，单位:ms ，默认为 15000 = 15秒
+        */
         timeout: number;
+        /**
+         * 发送前拦截处理
+        */
         beforeSend: (url: string, method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH', headers: HeadersInit, query: PlainObject) => [string, 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH', HeadersInit, PlainObject];
-        beforeReceive: () => [];
+        /**
+         * beforeReceive :
+         * 异步方法 （返回 Promise<结果>， 一般使用 async 方法）
+         * 例如 :
+         * beforeReceive: async (resp)=>{
+         *      let result: Result = await response.json();
+         *      return result;
+         * } ,
+        */
+        beforeReceive: (response: Response, requestUrl: string, requestOption: RequestInit) => Promise<any>;
         headers: Record<string, string>;
     };
     DATE: {
@@ -191,6 +212,23 @@ export type GlobalSetting = {
         */
         POPUP_CLEAR_ONOPEN: boolean;
     };
+    SEARCHBAND: {
+        /**
+         * 默认列个数
+        */
+        DEFALULT_COL: 1 | 2 | 3;
+        /**
+         * 默认使用 fix 模式 , 默认为true
+         * 设为flase ,默认使用 tag模式
+        */
+        FIX_MODE: boolean;
+        /**
+         * FIX 模式时, action 出现在左边还是右边
+         * 放左边(默认)时, 体验上可能会更符合人类直觉.
+         * 因vap内的 action 都出现在右边,所以放在右边有较好的一致性.
+        */
+        FIX_ACTION_POSTION: 'left' | 'right';
+    };
     GRID: {
         GUTTER: [number, number];
     };
@@ -267,6 +305,12 @@ export type GlobalSetting = {
          */
         UNSELECT_ON_QUERY: boolean;
     };
+    LIST: {
+        /**
+         * 说明 , 这个选项必须是 支持的list 字串的数组,如果没有,则会忽略
+        */
+        LAYOUT_ORDER: BaseOption[];
+    };
     PAGINATION: {
         SIZE: 'default' | 'small';
         /**

package/utils/Global.js

@@ -60,14 +60,22 @@ var DEFAULT = {
     VLIST: { list: 'list', total: 'total', totalAcc: 'totalAcc', start: 'start_', count: 'count_', order: 'order_', by: 'by_' },
     VDATA: { data: 'data' },
     BOX: { SELECT_CLOSE: 2 },
-    AJAX: { timeout: 30000, beforeSend: null, beforeReceive: null, headers: { 'Content-Type': 'application/json' } },
+    AJAX: {
+        timeout: 30000,
+        beforeSend: null,
+        beforeReceive: null,
+        headers: { 'Content-Type': 'application/json' },
+        disableCache: false,
+    },
     UPLOAD: {
         API: '/api-common/file/upload',
         PREVIEW: '/api-common/file/show/',
         UPLOAD_PARAM: true,
     },
     SEARCHBAR: {
-        REVERSE: false, USE_MODAL: false, DISABLE_KEYWORD: false,
+        REVERSE: false,
+        USE_MODAL: false,
+        DISABLE_KEYWORD: false,
         FIELD_AWAYS_OUTSIDE: false,
         AWAYS_EXPAND: false,
         FIELD_LABEL_WIDTH: 80,
@@ -79,11 +87,25 @@ var DEFAULT = {
         POPUP_BUTTONS_POSITION: 'left',
         POPUP_CLEAR_ONOPEN: false,
     },
+    SEARCHBAND: {
+        DEFALULT_COL: 2,
+        FIX_MODE: true,
+        FIX_ACTION_POSTION: 'left',
+    },
     TABLE: {
         SIZE: 'small',
         REQUERY_ON_DELETE: false,
         UNSELECT_ON_QUERY: false,
     },
+    LIST: {
+        LAYOUT_ORDER: [
+            { label: '宫格', value: 'grids', icon: 'appstore' },
+            { label: '字段平铺', value: 'fields', icon: 'unordered-list' },
+            { label: '表格', value: 'columns', icon: 'table' },
+            { label: '行模式', value: 'row', icon: 'menu' },
+            { label: '时间轴', value: 'timeline', icon: 'history' },
+        ],
+    },
     DATE: {
         DATE_FORMAT: 'YYYY-MM-DD',
         DATE_TIME_FORMAT: 'YYYY-MM-DD HH:mm:ss',