@ivujs/i-utils 1.1.18 → 2.0.0

package/dist/cjs/random/index.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+/**
+ * 生成指定大小的随机整数
+ * @description n和m参数表示最小和最大范围值，默认0-9之间范围
+ * @param {Number} min 随机数的最小值，默认 0
+ * @param {Number} max 随机数的最大值，默认 9
+ * @returns {Number} 返回指定大小的随机整数
+ */
+function getRandom(min = 0, max = 9) {
+    return Math.floor(Math.random() * (max - min + 1) + min);
+}
+/**
+ * 生成固定位数的随机整数
+ * @description 默认是1，代表生成0-9之间一位，如果是2，则生成10-99之间两位，以此类推
+ * @param {Number} len 固定的位数
+ * @returns {Number} 返回固定位数的随机数
+ */
+function getRandomDigit(len = 1) {
+    return Math.floor((Math.random() + Math.floor(Math.random() * 9 + 1)) * Math.pow(10, len - 1));
+}
+
+exports.getRandom = getRandom;
+exports.getRandomDigit = getRandomDigit;

package/dist/cjs/regexp/index.cjs

@@ -0,0 +1,100 @@
+'use strict';
+
+var regexp = require('../constants/regexp.cjs');
+
+/* 正则校验方法 */
+/**
+ * 正则校验的方法
+ * @description 类型为REGEXP对应的正则
+ * @param {String|Number} value 校验的参数
+ * @param {RegExp} regex 使用的REGEXP中的正则
+ * @returns {Boolean} 返回校验的结果
+ */
+function regexpTest(value, regex) {
+    return new RegExp(regex).test(value);
+}
+/* 常用校验 */
+/**
+ * 是中文
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isChinese(value) {
+    return regexpTest(value, regexp.REGEXP.CH);
+}
+/**
+ * 是英文
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isEnglish(value) {
+    return regexpTest(value, regexp.REGEXP.EN);
+}
+/**
+ * 是外链
+ * @description 支持http，https，mail，tel电话
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isExternal(value) {
+    return regexpTest(value, regexp.REGEXP.EXTERNAL);
+}
+/**
+ * 是小写字母
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isLowerCase(value) {
+    return regexpTest(value, regexp.REGEXP.LOWER_CASE);
+}
+/**
+ * 是大写字母
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isUpperCase(value) {
+    return regexpTest(value, regexp.REGEXP.UPPER_CASE);
+}
+/**
+ * 是11位手机号码
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isMobile(value) {
+    return regexpTest(value, regexp.REGEXP.MOBILE);
+}
+/**
+ * 是邮箱
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isEmail(value) {
+    return regexpTest(value, regexp.REGEXP.EMAIL);
+}
+/**
+ * 是身份证号码（15-18位）
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isIdCard(value) {
+    return regexpTest(value, regexp.REGEXP.ID_CARD);
+}
+/**
+ * 是url链接
+ * @param {String} value 校验的参数
+ * @returns {Boolean} 返回校验的结果
+ */
+function isUrl(value) {
+    return regexpTest(value, regexp.REGEXP.URL);
+}
+
+exports.isChinese = isChinese;
+exports.isEmail = isEmail;
+exports.isEnglish = isEnglish;
+exports.isExternal = isExternal;
+exports.isIdCard = isIdCard;
+exports.isLowerCase = isLowerCase;
+exports.isMobile = isMobile;
+exports.isUpperCase = isUpperCase;
+exports.isUrl = isUrl;
+exports.regexpTest = regexpTest;

package/dist/cjs/storage/index.cjs

@@ -0,0 +1,11 @@
+'use strict';
+
+/**
+ * 浏览器是否支持 Storage
+ * @returns {Boolean} 返回true和false
+ */
+function isSupportStorage() {
+    return !!(window.localStorage && window.sessionStorage);
+}
+
+exports.isSupportStorage = isSupportStorage;

package/dist/cjs/storage/localStorage.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+/* localStorage存储 */
+/**
+ * 通过key从localStorage缓存中获取数据
+ * @param {String} key key值
+ * @returns {String} 返回数据
+ */
+function getLocalStorage(key) {
+    return window.localStorage.getItem(key) || undefined;
+}
+/**
+ * 设置localStorage缓存数据
+ * @param {String} key key值
+ * @param {String} value value值
+ */
+function setLocalStorage(key, value) {
+    window.localStorage.setItem(key, value);
+}
+/**
+ * 通过key从localStorage缓存中删除数据
+ * @param {String} key key值
+ */
+function removeLocalStorage(key) {
+    window.localStorage.removeItem(key);
+}
+/**
+ * 清空localStorage缓存中所有数据
+ */
+function clearLocalStorage() {
+    window.localStorage.clear();
+}
+
+exports.clearLocalStorage = clearLocalStorage;
+exports.getLocalStorage = getLocalStorage;
+exports.removeLocalStorage = removeLocalStorage;
+exports.setLocalStorage = setLocalStorage;

package/dist/cjs/storage/sessionStorage.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+/* sessionStorage存储 */
+/**
+ * 通过key从sessionStorage缓存中获取数据
+ * @param {String} key key值
+ * @returns {String} 返回数据
+ */
+function getSessionStorage(key) {
+    return window.sessionStorage.getItem(key) || "";
+}
+/**
+ * 设置sessionStorage缓存数据
+ * @param {String} key key值
+ * @param {String} value value值
+ */
+function setSessionStorage(key, value) {
+    window.sessionStorage.setItem(key, value);
+}
+/**
+ * 通过key从sessionStorage缓存中删除数据
+ * @param {String} key key值
+ */
+function removeSessionStorage(key) {
+    window.sessionStorage.removeItem(key);
+}
+/**
+ * 清空sessionStorage缓存中所有数据
+ */
+function clearSessionStorage() {
+    window.sessionStorage.clear();
+}
+
+exports.clearSessionStorage = clearSessionStorage;
+exports.getSessionStorage = getSessionStorage;
+exports.removeSessionStorage = removeSessionStorage;
+exports.setSessionStorage = setSessionStorage;

package/dist/cjs/string/index.cjs

@@ -0,0 +1,358 @@
+'use strict';
+
+/* 字符串处理 */
+/**
+ * 字符串中是否包含指定的元素
+ * @param {String} value 包含的元素
+ * @param {String} str 查找的字符串
+ * @returns {Boolean} 返回true和false
+ */
+function inString(value, str) {
+    return str.includes(value);
+}
+/**
+ * 去除字符串前后位置空格
+ * @param {String} value 参数
+ * @returns {String} 返回处理后的字符串
+ */
+function trim(value) {
+    return value.replace(/(^\s*)|(\s*$)/g, "");
+}
+/**
+ * 去除字符串开始位置的空格
+ * @param {String} value 参数
+ * @returns {String} 返回处理后的字符串
+ */
+function trimStart(value) {
+    return value.replace(/(^\s*)/g, "");
+}
+/**
+ * 去除字符串结束位置的空格
+ * @param {String} value 参数
+ * @returns {String} 返回处理后的字符串
+ */
+function trimEnd(value) {
+    return value.replace(/(\s*$)/g, "");
+}
+/**
+ * 去除字符串中全部的空格
+ * @param {String} value 参数
+ * @returns {String} 返回处理后的字符串
+ */
+function trimAll(value) {
+    return value.replace(/\s+/g, "");
+}
+/**
+ * 替换所有指定字符串为新的字符串
+ * @param {String} value 参数
+ * @param {String} oldSubstr 需要替换的字符串
+ * @param {String} newSubstr 替换后的字符串
+ * @returns {String} 返回处理后的字符串
+ */
+function replaceAll(value, oldSubstr, newSubstr) {
+    return value.replace(new RegExp(oldSubstr, "gm"), newSubstr);
+}
+/* 字符串转换 */
+/**
+ * 字符串转大写
+ * @param {String} value 参数
+ * @returns {String} 返回处理后的字符串
+ */
+function toUpperCase(value) {
+    return String(value).toLocaleUpperCase();
+}
+/**
+ * 字符串转小写
+ * @param {String} value 参数
+ * @returns {String} 返回处理后的字符串
+ */
+function toLowerCase(value) {
+    String(value).toLocaleLowerCase();
+}
+/**
+ * 转为 snake_case 下划线命名
+ * @description 支持 驼峰命名，短横命名，帕斯卡命名
+ * @param {String} value 参数
+ * @returns {String} 返回处理后的字符串
+ */
+function toSnakeCase(value) {
+    // 驼峰
+    if (/^[a-z]$/.test(value.charAt(0)) && !(value.indexOf("-") > 0 || value.indexOf("_") > 0)) {
+        return value.replace(/([A-Z])/g, "_$1").toLowerCase();
+    }
+    // 短横
+    if (value.indexOf("-") > 0) {
+        return value.replace(/-/g, "_").toLowerCase();
+    }
+    // 帕斯卡
+    if (/^[A-Z]$/.test(value.charAt(0)) && !(value.indexOf("-") > 0 || value.indexOf("_") > 0)) {
+        value = value.charAt(0).toLowerCase() + value.slice(1);
+        return value.replace(/([A-Z])/g, "_$1").toLowerCase();
+    }
+}
+/**
+ * 转为 kebab-case 短横命名
+ * @description 支持 下划线，驼峰命名，帕斯卡命名
+ * @param {String} value 参数
+ * @returns {String} 返回处理后的字符串
+ */
+function toKebabCase(value) {
+    // 下划线
+    if (value.indexOf("_") > 0) {
+        return value.replace(/_/g, "-").toLowerCase();
+    }
+    // 驼峰
+    if (/^[a-z]$/.test(value.charAt(0)) && !(value.indexOf("-") > 0 || value.indexOf("_") > 0)) {
+        return value.replace(/([A-Z])/g, "-$1").toLowerCase();
+    }
+    // 帕斯卡
+    if (/^[A-Z]$/.test(value.charAt(0)) && !(value.indexOf("-") > 0 || value.indexOf("_") > 0)) {
+        let newStr = value.charAt(0).toLowerCase() + value.slice(1);
+        return newStr.replace(/([A-Z])/g, "-$1").toLowerCase();
+    }
+}
+/**
+ * 转为 camelCase 驼峰命名
+ * @description 支持 下划线命名，短横命名，帕斯卡命名
+ * @param {String} value 参数
+ * @returns {String} 返回处理后的字符串
+ */
+function toCamelCase(value) {
+    // 下划线
+    if (value.indexOf("_") > 0) {
+        return value.replace(/\_(\w)/g, function (all, letter) {
+            return letter.toUpperCase();
+        });
+    }
+    // 短横
+    else if (value.indexOf("-") > 0) {
+        return value.replace(/\-(\w)/g, function (all, letter) {
+            return letter.toUpperCase();
+        });
+    }
+    // 帕斯卡
+    else if (/^[A-Z]$/.test(value.charAt(0)) && !(value.indexOf("-") > 0 || value.indexOf("_") > 0)) {
+        return value.charAt(0).toLowerCase() + value.slice(1);
+    }
+    // 返回自身
+    else {
+        return value;
+    }
+}
+/**
+ * 转为 PascalCase 帕斯卡命名
+ * @description 支持 下划线命名，短横命名，驼峰命名
+ * @param {String} value 参数
+ * @returns {String} 返回处理后的字符串
+ */
+function toPascalCase(value) {
+    // 下划线
+    if (value.indexOf("_") > 0) {
+        let newStr = value.replace(/\_(\w)/g, function (all, letter) {
+            return letter.toUpperCase();
+        });
+        return newStr.charAt(0).toUpperCase() + newStr.slice(1);
+    }
+    // 短横
+    else if (value.indexOf("-") > 0) {
+        let newStr = value.replace(/\-(\w)/g, function (all, letter) {
+            return letter.toUpperCase();
+        });
+        return newStr.charAt(0).toUpperCase() + newStr.slice(1);
+    }
+    // 驼峰
+    else if (/^[a-z]$/.test(value.charAt(0)) && !(value.indexOf("-") > 0 || value.indexOf("_") > 0)) {
+        return value.charAt(0).toUpperCase() + value.slice(1);
+    }
+    // 返回自身
+    else {
+        return value;
+    }
+}
+/* 字符串格式化 */
+/**
+ * 数字前补齐0达到指定位数
+ * @description 相当于原生的 padStart(2,'0')
+ * @param {Number|String} value 补零的数字
+ * @param {Number} maxLength 补齐0后的最大长度，默认2位
+ * @returns {String} 返回补0后指定位数的字符串
+ */
+function zeroStart(value, maxLength = 2) {
+    let len = value.toString().length;
+    while (len < maxLength) {
+        value = "0" + value;
+        len++;
+    }
+    return value;
+}
+/**
+ * 数字后补齐0达到指定位数
+ * @description 相当于原生的 padEnd(2,'0')
+ * @param {Number|String} value 补零的数字
+ * @param {Number} maxLength 补齐0后的最大长度，默认2位
+ * @returns {String} 返回补0后指定位数的字符串
+ */
+function zeroEnd(value, maxLength = 2) {
+    let len = value.toString().length;
+    while (len < maxLength) {
+        value = value + "0";
+        len++;
+    }
+    return value;
+}
+/**
+ * 格式化为标题样式
+ * @param {String} value 字符串值
+ * @returns {String} 返回格式化后的标题样式
+ */
+function formatTitle(value) {
+    if (!value)
+        return "";
+    return value
+        .split(/(?=[A-Z])|[\.\-\s_]/)
+        .map((s) => s.trim())
+        .filter((s) => !!s)
+        .map((s) => toPascalCase(s.toLowerCase()))
+        .join(" ");
+}
+/**
+ * 格式化字符串模版
+ * @param {String} value 字符串值
+ * @param {Object} data 模版数据
+ * @returns {String} 返回格式化后的模版字符串
+ */
+function formatTemplate(value, data) {
+    if (!value)
+        return "";
+    return Array.from(value.matchAll(/\{\{(.+?)\}\}/g)).reduce((acc, match) => {
+        return acc.replace(match[0], data[match[1]]);
+    }, value);
+}
+/**
+ * 格式化千分位数字
+ * @description 支持任意数据传参，如果非数字则不会格式化，并返回原数据
+ * @param {Number|String} num 数字
+ * @returns {String} 返回格式化后的千分位数字
+ */
+function formatThousand(num) {
+    if (!parseFloat(num))
+        return num;
+    num = String(num);
+    let regex = num.indexOf(".") > -1 ? /(\d)(?=(\d{3})+\.)/g : /(\d)(?=(?:\d{3})+$)/g;
+    return num.replace(regex, "$1,");
+}
+/**
+ * 格式化人民币金额大写
+ * @param {Number|String} money 金额
+ * @returns {String} 返回金额大写
+ */
+function formatRmbChinese(money) {
+    // 汉字的数字
+    let cnNums = ["零", "壹", "贰", "叁", "肆", "伍", "陆", "柒", "捌", "玖"];
+    // 基本单位
+    let cnIntRadiance = ["", "拾", "佰", "仟"];
+    // 对应整数部分扩展单位
+    let cnIntUnits = ["", "万", "亿", "兆"];
+    // 对应小数部分单位
+    let cnDecUnits = ["角", "分", "毫", "厘"];
+    // 整数金额时后面跟的字符
+    let cnInteger = "整";
+    // 整型完以后的单位
+    let cnIntLast = "元";
+    // 最大处理的数字
+    let maxNum = Number("999999999999999.9999");
+    // 金额整数部分
+    let integerNum;
+    // 金额小数部分
+    let decimalNum;
+    // 输出的中文金额字符串
+    let chineseStr = "";
+    // 分离金额后用的数组，预定义
+    let parts;
+    if (money === "") {
+        // 不能用==
+        return "";
+    }
+    money = parseFloat(money);
+    if (money >= maxNum) {
+        // 超出最大处理数字，抛出异常
+        throw new Error("Calculated number overflow!");
+    }
+    if (money === 0) {
+        chineseStr = cnNums[0] + cnIntLast + cnInteger;
+        return chineseStr;
+    }
+    // 转换为字符串
+    money = money.toString();
+    if (money.indexOf(".") === -1) {
+        integerNum = money;
+        decimalNum = "";
+    }
+    else {
+        parts = money.split(".");
+        integerNum = parts[0];
+        decimalNum = parts[1].substr(0, 4);
+    }
+    // 获取整型部分转换
+    if (parseInt(integerNum, 10) > 0) {
+        let zeroCount = 0;
+        let IntLen = integerNum.length;
+        for (let i = 0; i < IntLen; i++) {
+            let n = integerNum.substr(i, 1);
+            let p = IntLen - i - 1;
+            let q = p / 4;
+            let m = p % 4;
+            if (n === "0") {
+                zeroCount++;
+            }
+            else {
+                if (zeroCount > 0) {
+                    chineseStr += cnNums[0];
+                }
+                // 归零
+                zeroCount = 0;
+                chineseStr += cnNums[parseInt(n)] + cnIntRadiance[m];
+            }
+            if (m === 0 && zeroCount < 4) {
+                chineseStr += cnIntUnits[q];
+            }
+        }
+        chineseStr += cnIntLast;
+    }
+    // 小数部分
+    if (decimalNum !== "") {
+        let decLen = decimalNum.length;
+        for (let i = 0; i < decLen; i++) {
+            let n = decimalNum.substr(i, 1);
+            if (n !== "0") {
+                chineseStr += cnNums[Number(n)] + cnDecUnits[i];
+            }
+        }
+    }
+    if (chineseStr === "") {
+        chineseStr += cnNums[0] + cnIntLast + cnInteger;
+    }
+    else if (decimalNum === "") {
+        chineseStr += cnInteger;
+    }
+    return chineseStr;
+}
+
+exports.formatRmbChinese = formatRmbChinese;
+exports.formatTemplate = formatTemplate;
+exports.formatThousand = formatThousand;
+exports.formatTitle = formatTitle;
+exports.inString = inString;
+exports.replaceAll = replaceAll;
+exports.toCamelCase = toCamelCase;
+exports.toKebabCase = toKebabCase;
+exports.toLowerCase = toLowerCase;
+exports.toPascalCase = toPascalCase;
+exports.toSnakeCase = toSnakeCase;
+exports.toUpperCase = toUpperCase;
+exports.trim = trim;
+exports.trimAll = trimAll;
+exports.trimEnd = trimEnd;
+exports.trimStart = trimStart;
+exports.zeroEnd = zeroEnd;
+exports.zeroStart = zeroStart;