@zcrkey/js-utils 0.0.7 → 0.0.9

package/dist/esm/util.js

@@ -27,19 +27,19 @@ var CrUtil = /*#__PURE__*/function () {
   _createClass(CrUtil, null, [{
     key: "isArray",
     value:
-    /**
-     * 判断是否为数组
-     * @param value
-     * @returns boolean
+    /**
+     * 判断是否为数组
+     * @param value
+     * @returns boolean
      */
     function isArray(value) {
       return Array.isArray(value);
     }
 
-    /**
-     * 判断是否为对象
-     * @param value
-     * @returns boolean
+    /**
+     * 判断是否为对象
+     * @param value
+     * @returns boolean
      */
   }, {
     key: "isObject",
@@ -47,10 +47,10 @@ var CrUtil = /*#__PURE__*/function () {
       return _typeof(value) === 'object' && value !== null && !CrUtil.isArray(value);
     }
 
-    /**
-     * 判断是否为空对象
-     * @param value
-     * @returns boolean
+    /**
+     * 判断是否为空对象
+     * @param value
+     * @returns boolean
      */
   }, {
     key: "isEmptyObject",
@@ -58,10 +58,10 @@ var CrUtil = /*#__PURE__*/function () {
       return Object.keys(value).length === 0 && value.constructor === Object;
     }
 
-    /**
-     * 判断是否对象的属性是否全部为空
-     * @param value
-     * @returns boolean
+    /**
+     * 判断是否对象的属性是否全部为空
+     * @param value
+     * @returns boolean
      */
   }, {
     key: "isObjectPropertiesAllEmpty",
@@ -72,10 +72,10 @@ var CrUtil = /*#__PURE__*/function () {
       });
     }
 
-    /**
-     * 判断是否为日期
-     * @param value
-     * @returns boolean
+    /**
+     * 判断是否为日期
+     * @param value
+     * @returns boolean
      */
   }, {
     key: "isDate",
@@ -83,10 +83,10 @@ var CrUtil = /*#__PURE__*/function () {
       return Object.prototype.toString.call(value) === '[object Date]';
     }
 
-    /**
-     * 判断是否为字符串
-     * @param value
-     * @returns boolean
+    /**
+     * 判断是否为字符串
+     * @param value
+     * @returns boolean
      */
   }, {
     key: "isString",
@@ -94,10 +94,10 @@ var CrUtil = /*#__PURE__*/function () {
       return Object.prototype.toString.call(value) === '[object String]';
     }
 
-    /**
-     * 判断是否为数字
-     * @param value
-     * @returns boolean
+    /**
+     * 判断是否为数字
+     * @param value
+     * @returns boolean
      */
   }, {
     key: "isNumber",
@@ -105,10 +105,10 @@ var CrUtil = /*#__PURE__*/function () {
       return typeof value === 'number' && !isNaN(value);
     }
 
-    /**
-     * 判断是否为文件 File
-     * @param value
-     * @returns boolean
+    /**
+     * 判断是否为文件 File
+     * @param value
+     * @returns boolean
      */
   }, {
     key: "isFile",
@@ -116,10 +116,10 @@ var CrUtil = /*#__PURE__*/function () {
       return Object.prototype.toString.call(value) === '[object File]';
     }
 
-    /**
-     * 判断是否为 Boolean
-     * @param value
-     * @returns boolean
+    /**
+     * 判断是否为 Boolean
+     * @param value
+     * @returns boolean
      */
   }, {
     key: "isBoolean",
@@ -127,10 +127,10 @@ var CrUtil = /*#__PURE__*/function () {
       return Object.prototype.toString.call(value) === '[object Boolean]';
     }
 
-    /**
-     * 判断是否为 Function
-     * @param value
-     * @returns boolean
+    /**
+     * 判断是否为 Function
+     * @param value
+     * @returns boolean
      */
   }, {
     key: "isFunction",
@@ -138,10 +138,10 @@ var CrUtil = /*#__PURE__*/function () {
       return typeof value === 'function';
     }
 
-    /**
-     * 去掉字符串前后所有空格
-     * @param str
-     * @returns string
+    /**
+     * 去掉字符串前后所有空格
+     * @param str
+     * @returns string
      */
   }, {
     key: "trim",
@@ -149,10 +149,10 @@ var CrUtil = /*#__PURE__*/function () {
       return (str + '').replace(/(^[\s\n\t]+|[\s\n\t]+$)/g, '');
     }
 
-    /**
-     * 获取数组为几维数组
-     * @param arr
-     * @returns number
+    /**
+     * 获取数组为几维数组
+     * @param arr
+     * @returns number
      */
   }, {
     key: "getArrayDimension",
@@ -170,10 +170,10 @@ var CrUtil = /*#__PURE__*/function () {
       return maxDimension + 1;
     }
 
-    /**
-     * 深拷贝
-     * @param value
-     * @returns
+    /**
+     * 深拷贝
+     * @param value
+     * @returns
      */
   }, {
     key: "cloneDeep",
@@ -181,11 +181,11 @@ var CrUtil = /*#__PURE__*/function () {
       return _cloneDeep(value);
     }
 
-    /**
-     * 深拷贝
-     * @param target
-     * @deprecated 即将移除，使用 {@link CrUtil.cloneDeep} 替代
-     * @returns
+    /**
+     * 深拷贝
+     * @param target
+     * @deprecated 即将移除，使用 {@link CrUtil.cloneDeep} 替代
+     * @returns
      */
   }, {
     key: "deepCopy",
@@ -215,15 +215,15 @@ var CrUtil = /*#__PURE__*/function () {
       return _target;
     }
 
-    /**
-     * 列表数据转树型数据
-     * @param listData
-     * @param settings
-     * @param settings.idField 默认值 id
-     * @param settings.pidField 默认值 parentId
-     * @param settings.childrenField 默认值 children
-     * @deprecated 即将移除，使用 {@link CrTreeUtil.listToTree} 替代
-     * @returns
+    /**
+     * 列表数据转树型数据
+     * @param listData
+     * @param settings
+     * @param settings.idField 默认值 id
+     * @param settings.pidField 默认值 parentId
+     * @param settings.childrenField 默认值 children
+     * @deprecated 即将移除，使用 {@link CrTreeUtil.listToTree} 替代
+     * @returns
      */
   }, {
     key: "listToTreeData",
@@ -325,15 +325,15 @@ var CrUtil = /*#__PURE__*/function () {
       return tree;
     }
 
-    /**
-     * 树型数据转列表数据
-     * @param treeData
-     * @param settings
-     * @param settings.idField 默认值 id
-     * @param settings.pidField 默认值 parentId
-     * @param settings.childrenField 默认值 children
-     * @deprecated 即将移除，使用 {@link CrTreeUtil.treeToList} 替代
-     * @returns
+    /**
+     * 树型数据转列表数据
+     * @param treeData
+     * @param settings
+     * @param settings.idField 默认值 id
+     * @param settings.pidField 默认值 parentId
+     * @param settings.childrenField 默认值 children
+     * @deprecated 即将移除，使用 {@link CrTreeUtil.treeToList} 替代
+     * @returns
      */
   }, {
     key: "treeDataToListData",
@@ -365,16 +365,16 @@ var CrUtil = /*#__PURE__*/function () {
       return listData;
     }
 
-    /**
-     * 获取所有父级数据（包含自身）
-     * @param listData
-     * @param value
-     * @param settings
-     * @param settings.valueField 默认值 value
-     * @param settings.idField 默认值 id
-     * @param settings.pidField 默认值 parentId
-     * @deprecated 即将移除，使用 {@link CrTreeUtil.getFlatParentDatas} 替代
-     * @returns
+    /**
+     * 获取所有父级数据（包含自身）
+     * @param listData
+     * @param value
+     * @param settings
+     * @param settings.valueField 默认值 value
+     * @param settings.idField 默认值 id
+     * @param settings.pidField 默认值 parentId
+     * @deprecated 即将移除，使用 {@link CrTreeUtil.getFlatParentDatas} 替代
+     * @returns
      */
   }, {
     key: "getParentNodes",
@@ -415,10 +415,10 @@ var CrUtil = /*#__PURE__*/function () {
       return nodes;
     }
 
-    /**
-     * 参数序列化
-     * @param params {a:'1',b:{},c:[]}
-     * @returns
+    /**
+     * 参数序列化
+     * @param params {a:'1',b:{},c:[]}
+     * @returns
      */
   }, {
     key: "paramsSerializer",
@@ -436,11 +436,11 @@ var CrUtil = /*#__PURE__*/function () {
       return Qs.stringify(params);
     }
 
-    /**
-     * 参数解析
-     * @param {*} str
-     * @param {*} settings
-     * @returns
+    /**
+     * 参数解析
+     * @param {*} str
+     * @param {*} settings
+     * @returns
      */
   }, {
     key: "paramsParse",
@@ -455,13 +455,13 @@ var CrUtil = /*#__PURE__*/function () {
       return obj;
     }
 
-    /**
-     * 获取 URL 参数
-     * @param {*} url
-     * @returns
-     * @example
-     * "https://example.com?foo=bar&baz=qux" => {"query":{"foo":"bar","baz":"qux"},"hash":{},"all":{"foo":"bar","baz":"qux"}}
-     * "https://example.com/page?foo=1#/?a=1&b=2" => {"query":{"foo":"1"},"hash":{"/":"","a":"1","b":"2"},"all":{"foo":"1","/":"","a":"1","b":"2"}},
+    /**
+     * 获取 URL 参数
+     * @param {*} url
+     * @returns
+     * @example
+     * "https://example.com?foo=bar&baz=qux" => {"query":{"foo":"bar","baz":"qux"},"hash":{},"all":{"foo":"bar","baz":"qux"}}
+     * "https://example.com/page?foo=1#/?a=1&b=2" => {"query":{"foo":"1"},"hash":{"/":"","a":"1","b":"2"},"all":{"foo":"1","/":"","a":"1","b":"2"}},
      */
   }, {
     key: "getQueryParams",
@@ -521,12 +521,12 @@ var CrUtil = /*#__PURE__*/function () {
       };
     }
 
-    /**
-     * 版本号比较
-     * @param v1
-     * @param v2
-     * @returns number
-     * @description v1大于v2(1)、v1小于v2(-1)、v1等于v2(0)
+    /**
+     * 版本号比较
+     * @param v1
+     * @param v2
+     * @returns number
+     * @description v1大于v2(1)、v1小于v2(-1)、v1等于v2(0)
      */
   }, {
     key: "compareVersion",
@@ -552,12 +552,12 @@ var CrUtil = /*#__PURE__*/function () {
       return 0;
     }
 
-    /**
-     * 根据 ids 获取相对应的数据名称
-     * @param data
-     * @param ids
-     * @param settings
-     * @returns string
+    /**
+     * 根据 ids 获取相对应的数据名称
+     * @param data
+     * @param ids
+     * @param settings
+     * @returns string
      */
   }, {
     key: "getDataNameByIds",
@@ -583,13 +583,13 @@ var CrUtil = /*#__PURE__*/function () {
       return str;
     }
 
-    /**
-     * 追加html标签属性值
-     * @param htmlStr
-     * @param tagName
-     * @param attrName
-     * @param newAttrValue
-     * @returns string
+    /**
+     * 追加html标签属性值
+     * @param htmlStr
+     * @param tagName
+     * @param attrName
+     * @param newAttrValue
+     * @returns string
      */
   }, {
     key: "appendHtmlTagAttr",
@@ -610,11 +610,11 @@ var CrUtil = /*#__PURE__*/function () {
       return replacedHtml;
     }
 
-    /**
-     * 比较数据差异
-     * @param data1
-     * @param data2
-     * @returns
+    /**
+     * 比较数据差异
+     * @param data1
+     * @param data2
+     * @returns
      */
   }, {
     key: "compareDataDiff",
@@ -671,10 +671,10 @@ var CrUtil = /*#__PURE__*/function () {
       return diffFieldSet;
     }
 
-    /**
-     * 格式化为千分位
-     * @param value
-     * @returns 12345.6789 => 12,345.6789
+    /**
+     * 格式化为千分位，主要用于展示格式化
+     * @param value
+     * @returns 12345.6789 => 12,345.6789
      */
   }, {
     key: "fmtThousands",
@@ -689,6 +689,55 @@ var CrUtil = /*#__PURE__*/function () {
       var formattedInt = intPart.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
       return decimalPart ? "".concat(formattedInt, ".").concat(decimalPart) : formattedInt;
     }
+
+    /**
+     * 格式化为千分位格式
+     * @param value 
+     * @returns 
+     */
+  }, {
+    key: "formatThousands",
+    value: function formatThousands(value) {
+      if (value == null) return '';
+      var raw = String(value).trim();
+      if (!raw) return '';
+      // 是否末尾点
+      var hasTrailingDot = raw.endsWith('.');
+      // 只保留数字/点/负号
+      var str = raw.replace(/[^\d.-]/g, '');
+      // 负号只留开头
+      var sign = str.startsWith('-') ? '-' : '';
+      str = str.replace(/-/g, '');
+      // 提取整数/小数（只认第一个点）
+      var _str$split = str.split('.', 2),
+        _str$split2 = _slicedToArray(_str$split, 2),
+        intRaw = _str$split2[0],
+        _str$split2$ = _str$split2[1],
+        decRaw = _str$split2$ === void 0 ? '' : _str$split2$;
+      // 整数去逗号+前导0
+      var intPart = intRaw.replace(/,/g, '').replace(/^0+(?=\d)/, '');
+      // 千分位
+      var formattedInt = intPart ? intPart.replace(/\B(?=(\d{3})+(?!\d))/g, ',') : '';
+      var result = sign + formattedInt;
+      if (decRaw || hasTrailingDot) result += '.';
+      if (decRaw) result += decRaw;
+      return result;
+    }
+
+    /**
+     * 解析千分位格式
+     * @param value 
+     * @returns 
+     */
+  }, {
+    key: "parseThousands",
+    value: function parseThousands(value) {
+      if (value == null) return '';
+      return String(value).trim().replace(/,/g, '') // 去千分位
+      .replace(/[^\d.-]/g, '') // 去非法
+      .replace(/(?!^)-/g, '') // 只留首负号
+      .replace(/(\..*)\./g, '$1'); // 只留第一个点
+    }
   }]);
   return CrUtil;
 }();