@ivujs/i-utils 1.1.14 → 1.1.16

package/dist/es/desensitized/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 指定位置的字符串转为星号
+ * @param {String|Number} value 字符串参数
+ * @param {Number} start 转换开始位置
+ * @param {Number} len 显示星号的长度
+ * @returns {String} 返回转化后字符串
+ */
+export function formatStartOf(value: string | number, start: number, len: number): string;
+/**
+ * 姓名中间转为星号
+ * @param {String} value 姓名
+ * @returns {String} 返回转化后字符串
+ */
+export function formatStartOfName(value: string): string;
+/**
+ * 手机号码固定位数转为星号
+ * @param {String} value 手机号码
+ * @param {Number} start 前缀长度，默认3位
+ * @param {Number} len 显示星号的长度，默认4位
+ * @returns {String} 返回转化后字符串
+ */
+export function formatStartOfMobile(value: string, start?: number, len?: number): string;
+/**
+ * 身份证号码固定位数转为星号
+ * @param {String} value 身份证号码
+ * @param {Number} start 前缀长度，默认4位
+ * @param {Number} len 显示星号的长度，默认8位
+ * @returns {String} 返回转化后字符串
+ */
+export function formatStartOfIDCard(value: string, start?: number, len?: number): string;
+/**
+ * 银行卡号固定位数转为星号
+ * @param {String} value 银行卡号
+ * @param {Number} start 前缀长度，默认4位
+ * @param {Number} len 显示星号的长度，默认10位
+ * @returns {String} 返回转化后字符串
+ */
+export function formatStartOfBankCard(value: string, start?: number, len?: number): string;

package/dist/es/desensitized/index.mjs

@@ -0,0 +1,69 @@
+/**
+ * 指定位置的字符串转为星号
+ * @param {String|Number} value 字符串参数
+ * @param {Number} start 转换开始位置
+ * @param {Number} len 显示星号的长度
+ * @returns {String} 返回转化后字符串
+ */
+function formatStartOf(value, start, len) {
+    value = String(value);
+    if (start > value.length)
+        return value;
+    // len小于0和len大于剩余长度
+    let startStr = "";
+    if (len < 0)
+        len = 0;
+    if (len > value.length - start) {
+        len = value.length - start;
+    }
+    startStr = String().padEnd(len, "*");
+    return value.substring(0, start) + startStr + value.substring(start + len);
+}
+/**
+ * 姓名中间转为星号
+ * @param {String} value 姓名
+ * @returns {String} 返回转化后字符串
+ */
+function formatStartOfName(value) {
+    if (value.length === 2) {
+        return formatStartOf(value, 1, 1);
+    }
+    else if (value.length > 2) {
+        return formatStartOf(value, 1, value.length - 2);
+    }
+    else {
+        return value;
+    }
+}
+/**
+ * 手机号码固定位数转为星号
+ * @param {String} value 手机号码
+ * @param {Number} start 前缀长度，默认3位
+ * @param {Number} len 显示星号的长度，默认4位
+ * @returns {String} 返回转化后字符串
+ */
+function formatStartOfMobile(value, start = 3, len = 4) {
+    return formatStartOf(value, start, len);
+}
+/**
+ * 身份证号码固定位数转为星号
+ * @param {String} value 身份证号码
+ * @param {Number} start 前缀长度，默认4位
+ * @param {Number} len 显示星号的长度，默认8位
+ * @returns {String} 返回转化后字符串
+ */
+function formatStartOfIDCard(value, start = 4, len = 8) {
+    return formatStartOf(value, start, len);
+}
+/**
+ * 银行卡号固定位数转为星号
+ * @param {String} value 银行卡号
+ * @param {Number} start 前缀长度，默认4位
+ * @param {Number} len 显示星号的长度，默认10位
+ * @returns {String} 返回转化后字符串
+ */
+function formatStartOfBankCard(value, start = 4, len = 11) {
+    return formatStartOf(value, start, len);
+}
+
+export { formatStartOf, formatStartOfBankCard, formatStartOfIDCard, formatStartOfMobile, formatStartOfName };

package/dist/es/device/index.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 获取浏览器信息
+ * @description 会获取到浏览器对应的名称以及版本
+ * @returns {Object} 返回浏览器信息
+ */
+export function getBrowserInfo(): Object;
+/**
+ * 判断是pc端
+ * @returns {Boolean} 返回true和false
+ */
+export function isPc(): boolean;
+/**
+ * 判断是手机端
+ * @description 包含 android、iphone、黑莓手机、微软手机 等多种操作系统机型
+ * @returns {Boolean} 返回true和false
+ */
+export function isPhone(): boolean;
+/**
+ * 判断是 android
+ * @returns {Boolean} 返回true和false
+ */
+export function isAndroid(): boolean;
+/**
+ * 判断是 ios
+ * @returns {Boolean} 返回true和false
+ */
+export function isIos(): boolean;
+/**
+ * 判断是 windows phone
+ * @returns {Boolean} 返回true和false
+ */
+export function isWindowsPhone(): boolean;
+/**
+ * 判断是 windows
+ * @returns {Boolean} 返回true和false
+ */
+export function isWindows(): boolean;
+/**
+ * 判断是 linux
+ * @returns {Boolean} 返回true和false
+ */
+export function isLinux(): boolean;
+/**
+ * 判断是 Mac
+ * @returns {Boolean} 返回true和false
+ */
+export function isMac(): boolean;
+/**
+ * 判断是iphone
+ *@returns {Boolean} 返回true和false
+ */
+export function isIphone(): boolean;
+/**
+ * 判断是ipad
+ *@return {Boolean} 返回true和false
+ */
+export function isIpad(): boolean;
+/**
+ * 判断是微信内置浏览器
+ * @returns {Boolean} 返回true和false
+ */
+export function isWeixin(): boolean;
+/**
+ * 判断是QQ内置浏览器
+ * @returns {Boolean} 返回true和false
+ */
+export function isQQ(): boolean;

package/dist/es/device/index.mjs

@@ -0,0 +1,137 @@
+/* 浏览器信息 */
+/**
+ * 获取浏览器信息
+ * @description 会获取到浏览器对应的名称以及版本
+ * @returns {Object} 返回浏览器信息
+ */
+function getBrowserInfo() {
+    let ua = window.navigator.userAgent.toLowerCase();
+    // ie
+    let ie = ua.match(/rv:([\d.]+)\) like gecko/) || ua.match(/msie ([\d\.]+)/);
+    // edge
+    let edge = ua.match(/edg\/([\d\.]+)/);
+    // firefox
+    let firefox = ua.match(/firefox\/([\d\.]+)/);
+    // opera
+    let opera = ua.match(/(?:opera|opr).([\d\.]+)/);
+    // chrome
+    let chrome = ua.match(/chrome\/([\d\.]+)/);
+    // safari
+    let safari = ua.match(/version\/([\d\.]+).*safari/);
+    // 判断类型
+    if (ie)
+        return { name: "ie", version: ie[1] };
+    if (edge)
+        return { name: "edge", version: edge[1] };
+    if (firefox)
+        return { name: "firefox", version: firefox[1] };
+    if (opera)
+        return { name: "opera", version: opera[1] };
+    if (chrome)
+        return { name: "chrome", version: chrome[1] };
+    if (safari)
+        return { name: "safari", version: safari[1] };
+    return "unknown";
+}
+/* 设备类型 */
+/**
+ * 判断是pc端
+ * @returns {Boolean} 返回true和false
+ */
+function isPc() {
+    return !isPhone();
+}
+/**
+ * 判断是手机端
+ * @description 包含 android、iphone、黑莓手机、微软手机 等多种操作系统机型
+ * @returns {Boolean} 返回true和false
+ */
+function isPhone() {
+    let ua = window.navigator.userAgent;
+    return /Android|webOS|iPhone|iPod|BlackBerry|Windows Phone|IEMobile/i.test(ua);
+}
+/* 操作系统类型 */
+/**
+ * 判断是 android
+ * @returns {Boolean} 返回true和false
+ */
+function isAndroid() {
+    let ua = window.navigator.userAgent;
+    return /Android|BlackBerry/i.test(ua);
+}
+/**
+ * 判断是 ios
+ * @returns {Boolean} 返回true和false
+ */
+function isIos() {
+    let ua = window.navigator.userAgent;
+    return /iPhone|iPad|iPod|iOS/i.test(ua);
+}
+/**
+ * 判断是 windows phone
+ * @returns {Boolean} 返回true和false
+ */
+function isWindowsPhone() {
+    let ua = window.navigator.userAgent;
+    return /Windows Phone/i.test(ua);
+}
+/**
+ * 判断是 windows
+ * @returns {Boolean} 返回true和false
+ */
+function isWindows() {
+    let ua = window.navigator.userAgent;
+    return /win/i.test(ua);
+}
+/**
+ * 判断是 linux
+ * @returns {Boolean} 返回true和false
+ */
+function isLinux() {
+    let ua = window.navigator.userAgent;
+    return /linux/i.test(ua);
+}
+/**
+ * 判断是 Mac
+ * @returns {Boolean} 返回true和false
+ */
+function isMac() {
+    let ua = window.navigator.userAgent;
+    return /mac/i.test(ua);
+}
+/* 苹果设备类型 */
+/**
+ * 判断是iphone
+ *@returns {Boolean} 返回true和false
+ */
+function isIphone() {
+    let ua = window.navigator.userAgent;
+    return /iPhone/i.test(ua);
+}
+/**
+ * 判断是ipad
+ *@return {Boolean} 返回true和false
+ */
+function isIpad() {
+    let ua = window.navigator.userAgent;
+    return /iPod/i.test(ua);
+}
+/* 手机浏览器类型 */
+/**
+ * 判断是微信内置浏览器
+ * @returns {Boolean} 返回true和false
+ */
+function isWeixin() {
+    let ua = window.navigator.userAgent;
+    return /MicroMessenger/i.test(ua);
+}
+/**
+ * 判断是QQ内置浏览器
+ * @returns {Boolean} 返回true和false
+ */
+function isQQ() {
+    let ua = window.navigator.userAgent;
+    return /QQ/i.test(ua);
+}
+
+export { getBrowserInfo, isAndroid, isIos, isIpad, isIphone, isLinux, isMac, isPc, isPhone, isQQ, isWeixin, isWindows, isWindowsPhone };

package/dist/es/dom/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 判断元素包含某个类名
+ * @param {Element} elem 元素
+ * @param {String} className 类名
+ * @return {Boolean} 返回true和false
+ */
+export function hasClass(elem: Element, className: string): boolean;
+/**
+ * 元素添加类名
+ * @param {Element} elem 元素
+ * @param {String} className 类名
+ */
+export function addClass(elem: Element, className: string): void;
+/**
+ * 元素删除类名
+ * @param {Element} elem 元素
+ * @param {String} className 类名
+ */
+export function removeClass(elem: Element, className: string): void;
+/**
+ * 元素替换类名
+ * @param {Element} elem 元素
+ * @param {String} newClassName 新的类名
+ * @param {String} oldClassName 被替换掉的旧类名
+ */
+export function replaceClass(elem: Element, newClassName: string, oldClassName: string): void;
+/**
+ * 添加元素的style样式
+ * @param {Element} elem 元素
+ * @param {Object} styles 样式属性集合
+ */
+export function addStyle(elem: Element, styles?: Object): void;
+/**
+ * 获取元素的style样式
+ * @param {Element} elem 元素
+ * @param {String} name 属性
+ * @returns {String} 返回样式的值
+ */
+export function getStyle(elem: Element, name: string): string;
+/**
+ * 删除元素的style样式
+ * @param {Element} elem 元素
+ * @param {String} name 属性
+ */
+export function removeStyle(elem: Element, name: string): void;
+/**
+ * html标签转义
+ * @param {String} htmlStr html字符串
+ * @returns {String} 返回转义后的字符串
+ */
+export function htmlEncode(htmlStr: string): string;
+/**
+ * html标签解码
+ * @param {String} htmlStr html字符串
+ * @returns {String} 返回解析后的字符串
+ */
+export function htmlDecode(htmlStr: string): string;

package/dist/es/dom/index.mjs

@@ -0,0 +1,119 @@
+/* Class操作 */
+/**
+ * 判断元素包含某个类名
+ * @param {Element} elem 元素
+ * @param {String} className 类名
+ * @return {Boolean} 返回true和false
+ */
+function hasClass(elem, className) {
+    return elem.className.indexOf(className) > 0;
+}
+/**
+ * 元素添加类名
+ * @param {Element} elem 元素
+ * @param {String} className 类名
+ */
+function addClass(elem, className) {
+    if (!hasClass(elem, className)) {
+        elem.className += " " + className;
+    }
+}
+/**
+ * 元素删除类名
+ * @param {Element} elem 元素
+ * @param {String} className 类名
+ */
+function removeClass(elem, className) {
+    if (hasClass(elem, className)) {
+        elem.className = elem.className.replace(new RegExp(className, "gm"), "");
+    }
+}
+/**
+ * 元素替换类名
+ * @param {Element} elem 元素
+ * @param {String} newClassName 新的类名
+ * @param {String} oldClassName 被替换掉的旧类名
+ */
+function replaceClass(elem, newClassName, oldClassName) {
+    removeClass(elem, oldClassName);
+    addClass(elem, newClassName);
+}
+/* Style操作 */
+/**
+ * 添加元素的style样式
+ * @param {Element} elem 元素
+ * @param {Object} styles 样式属性集合
+ */
+function addStyle(elem, styles = {}) {
+    if (!elem)
+        return;
+    for (let key in styles) {
+        elem.style[key] = styles[key];
+    }
+}
+/**
+ * 获取元素的style样式
+ * @param {Element} elem 元素
+ * @param {String} name 属性
+ * @returns {String} 返回样式的值
+ */
+function getStyle(elem, name) {
+    if (!elem)
+        return;
+    return elem.style[name];
+}
+/**
+ * 删除元素的style样式
+ * @param {Element} elem 元素
+ * @param {String} name 属性
+ */
+function removeStyle(elem, name) {
+    if (!elem)
+        return;
+    elem.style.removeProperty(name);
+}
+/* Html转码 */
+/**
+ * html标签转义
+ * @param {String} htmlStr html字符串
+ * @returns {String} 返回转义后的字符串
+ */
+function htmlEncode(htmlStr) {
+    const temp = {
+        "<": "&lt;",
+        ">": "&gt;",
+        "&": "&amp;",
+        "(": "&#40;",
+        ")": "&#41;",
+        "/": "&#47;",
+        " ": "&nbsp;",
+        '"': "&quot;",
+        "'": "&#39;",
+    };
+    return htmlStr.replace(/[<>&|()\/ '"]/g, function (c) {
+        return temp[c];
+    });
+}
+/**
+ * html标签解码
+ * @param {String} htmlStr html字符串
+ * @returns {String} 返回解析后的字符串
+ */
+function htmlDecode(htmlStr) {
+    const temp = {
+        "&lt;": "<",
+        "&gt;": ">",
+        "&amp;": "&",
+        "&#40;": "(",
+        "&#41;": ")",
+        "&#47;": "/",
+        "&nbsp;": " ",
+        "&quot;": '"',
+        "&#39;": "'",
+    };
+    return htmlStr.replace(/(&lt;|&gt;|&amp;|&#40;|&#41;|&#47;|&nbsp;|&quot;|&#39;)/gi, function (all, t) {
+        return temp[t];
+    });
+}
+
+export { addClass, addStyle, getStyle, hasClass, htmlDecode, htmlEncode, removeClass, removeStyle, replaceClass };

package/dist/es/file/index.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 格式化文件大小自动转为 B，KB，MB，GB
+ * @param {Number} size 文件的大小，单位byte字节
+ * @returns {String} 返回格式化后的字符串
+ */
+export function formatFileSize(size: number): string;
+/**
+ * 获得文件名称
+ * @param {String} fileName 文件的全名称，例如：测试图片.jpg
+ * @returns {String} 返回文件的名称
+ */
+export function getFileName(fileName: string): string;
+/**
+ * 获得文件后缀名
+ * @param {String} value 文件地址路径或者文件全名称，例如：http://xxx.com/mytest.jpg，测试图片.jpg
+ * @returns {String} 返回文件后缀名
+ */
+export function getFileSuffix(value: string): string;
+/**
+ * file转blob
+ * @param {File} file file文件
+ * @returns {Promise} 返回Promise的blob
+ */
+export function fileToBlob(file: File): Promise<any>;
+/**
+ * file转base64
+ * @param {File} file file文件
+ * @returns {Promise} 返回Promise的base64
+ */
+export function fileToBase64(file: File): Promise<any>;
+/**
+ * file转url
+ * @description 适用于本地上传图片并预览，需要注意 URL.revokeObjectURL(file) 内存释放
+ * @param {File} file file文件
+ * @returns {Promise} 返回Promise的url
+ */
+export function fileToUrl(file: File): Promise<any>;
+/**
+ * url赚file
+ * @param {String} url url地址
+ * @returns {Promise} 返回Promise的file
+ */
+export function urlToFile(url: string): Promise<any>;
+/**
+ * blob转file
+ * @param {Blob} blob blob数据
+ * @param {String} fileName 文件名称，默认以时间戳命名
+ * @returns {Promise} 返回Promise的file
+ */
+export function blobToFile(blob: Blob, fileName?: string): Promise<any>;
+/**
+ * blob转文本
+ * @param {Blob} blob blob数据
+ * @returns {Promise} 返回Promise的文本
+ */
+export function blobToText(blob: Blob): Promise<any>;
+/**
+ * blob转base64
+ * @param {Blob} blob blob数据
+ * @returns {Promise} 返回Promise的base64
+ */
+export function blobToBase64(blob: Blob): Promise<any>;
+/**
+ * base64转file
+ * @param {String} base64 base64数据
+ * @param {String} fileName 文件名称，默认以时间戳命名
+ * @returns {Promise} 返回Promise的file
+ */
+export function base64ToFile(base64: string, fileName?: string): Promise<any>;
+/**
+ * base64转成blob
+ * @param {String} base64 base64数据
+ * @returns {Promise} 返回Promise的blob
+ */
+export function base64ToBlob(base64: string): Promise<any>;
+/**
+ * 图片url转base64
+ * @param {String} imgUrl 图片url地址
+ * @returns {Promise} 返回Promise的base64
+ */
+export function urlToBase64(imgUrl: string): Promise<any>;
+/**
+ * 下载blob格式的文件
+ * @param {Blob} blob blob数据
+ * @param {String} fileName 下载的文件名，不写后缀名则默认为原文件类型
+ */
+export function downloadBlobFile(blob: Blob, fileName: string): void;
+/**
+ * 通过文件url地址下载
+ * @param {String} fileUrl url文件地址
+ * @param {String} fileName 下载的文件名，不写后缀名则默认为原文件类型
+ */
+export function downloadFileUrl(fileUrl: string, fileName: string): void;