youtil 1.0.2 → 1.0.3

package/README.md

@@ -1,3 +1,33 @@
 # youtil
 
-油梯，一个与框架（Vue、React等）、环境（Nodejs、Web等）无关的小巧、精简、实用的JavaScript工具库
+`youtil`，发音同`util`，中文可以叫做`油梯`，一个与框架（Vue、React等）、环境（Nodejs、Web等）无关的小巧、精简、实用、不依赖任何第三方库的`JavaScript`工具库。
+
+> 代码还在不断扩充，敬请期待！
+
+## 如何使用
+
+安装：`npm i youtil -S`
+
+使用示例：
+
+```js
+import { formatDate, parseDate } from youtil;
+console.log(formatDate(Date.now()));
+conssole.log(parseDate('2023-02-14', 'yyyy-MM-dd'));
+```
+
+## API
+
+参见[index.d.ts]('./dist/index.d.ts');
+
+## 关于命名
+
+之前想了很多名字，包括`autil`、`zutil`、`feutil`等，从a-z试下来只有几个没有被注册，但是不好记，最后才取了这个名字，因为比较好记。
+
+## 代码提交顺序
+
+* 修改代码；
+* 更新changelog和package.json
+* npm publish
+* git push
+

package/dist/index.js

@@ -119,7 +119,7 @@ exports.default = {
             ${config.hasMask ? `<div class="mask-wrapper" style="background-color: ${config.maskColor}"></div>` : ''}
             <div class="loading-wrapper">
                 <div class="loading-content">
-                    <img src="//img.alicdn.com/tfs/TB1bnUsQBLoK1RjSZFuXXXn0XXa-32-32.svg" alt="加载中">
+                    <img src="https://img.alicdn.com/tfs/TB1bnUsQBLoK1RjSZFuXXXn0XXa-32-32.svg" alt="加载中">
                     <div>${text}${config.cancelInline ? ' ' : '</div>'}
                     ${config.onCancel ? '<a href="javascript:;" class="cancel">取消</a>' : ''}
                     ${config.cancelInline ? '</div>' : ''}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "youtil",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "油梯，一个与框架、环境无关的小巧、精简、实用的JavaScript工具库",
   "main": "dist/index.js",
   "dependencies": {},

package/src/index.ts

@@ -124,7 +124,7 @@ export default {
             ${config.hasMask ? `<div class="mask-wrapper" style="background-color: ${config.maskColor}"></div>` : ''}
             <div class="loading-wrapper">
                 <div class="loading-content">
-                    <img src="//img.alicdn.com/tfs/TB1bnUsQBLoK1RjSZFuXXXn0XXa-32-32.svg" alt="加载中">
+                    <img src="https://img.alicdn.com/tfs/TB1bnUsQBLoK1RjSZFuXXXn0XXa-32-32.svg" alt="加载中">
                     <div>${text}${config.cancelInline ? ' ' : '</div>'}
                     ${config.onCancel ? '<a href="javascript:;" class="cancel">取消</a>' : ''}
                     ${config.cancelInline ? '</div>' : ''}

package/src/index.js

@@ -1,206 +0,0 @@
-"use strict";
-exports.__esModule = true;
-exports["default"] = {
-    /**
-     * 将日期格式化成指定格式的字符串
-     * @param date 要格式化的日期，不传时默认当前时间，也可以是一个时间戳
-     * @param fmt 目标字符串格式，支持的字符有：y,M,d,q,w,H,h,m,S，默认：yyyy-MM-dd HH:mm:ss
-     * @returns 返回格式化后的日期字符串
-     */
-    formatDate: function (date, fmt) {
-        if (!date) {
-            return '';
-        }
-        date = typeof date === 'number' ? new Date(date) : date;
-        fmt = fmt || 'yyyy-MM-dd HH:mm:ss';
-        var obj = {
-            y: date.getFullYear(),
-            M: date.getMonth() + 1,
-            d: date.getDate(),
-            q: Math.floor((date.getMonth() + 3) / 3),
-            w: date.getDay(),
-            H: date.getHours(),
-            h: date.getHours() % 12 === 0 ? 12 : date.getHours() % 12,
-            m: date.getMinutes(),
-            s: date.getSeconds(),
-            S: date.getMilliseconds()
-        };
-        var week = ['天', '一', '二', '三', '四', '五', '六'];
-        var _loop_1 = function (i) {
-            fmt = fmt.replace(new RegExp("".concat(i, "+"), 'g'), function (m) {
-                var val = "".concat(obj[i]);
-                if (i === 'w') {
-                    return (m.length > 2 ? '星期' : '周') + week[val];
-                }
-                for (var j = 0, len = val.length; j < m.length - len; j++) {
-                    val = "0".concat(val);
-                }
-                return m.length === 1 ? val : val.substring(val.length - m.length);
-            });
-        };
-        // eslint-disable-next-line guard-for-in
-        for (var i in obj) {
-            _loop_1(i);
-        }
-        return fmt;
-    },
-    /**
-     * 将字符串解析成日期
-     * @param str 输入的日期字符串，如'2014-09-13'
-     * @param fmt 字符串格式，默认'yyyy-MM-dd'，支持如下：y、M、d、H、m、s、S，不支持w和q
-     * @returns 解析后的Date类型日期
-     */
-    parseDate: function (str, fmt) {
-        fmt = fmt || 'yyyy-MM-dd';
-        var obj = { y: 0, M: 1, d: 0, H: 0, h: 0, m: 0, s: 0, S: 0 };
-        fmt.replace(/([^yMdHmsS]*?)(([yMdHmsS])\3*)([^yMdHmsS]*?)/g, function (m, $1, $2, $3, $4) {
-            str = str.replace(new RegExp("".concat($1, "(\\d{").concat($2.length, "})").concat($4)), function (_m, _$1) {
-                obj[$3] = parseInt(_$1);
-                return '';
-            });
-            return '';
-        });
-        obj.M--; // 月份是从0开始的，所以要减去1
-        var date = new Date(obj.y, obj.M, obj.d, obj.H, obj.m, obj.s);
-        if (obj.S !== 0) {
-            date.setMilliseconds(obj.S); // 如果设置了毫秒
-        }
-        return date;
-    },
-    /**
-     * 显示全局loading
-     * @param {*} text
-     * @param {*} seconds
-     * @param {*} options
-     */
-    showLoading: function (text, seconds, config) {
-        var _this = this;
-        if (text === void 0) { text = '请稍候'; }
-        if (seconds === void 0) { seconds = 10; }
-        if (config === void 0) { config = {}; }
-        var defaultConfig = {
-            hasMask: true,
-            maskColor: 'transparent',
-            onCancel: null,
-            cancelInline: false,
-            id: 'com_global_page_loading'
-        };
-        config = Object.assign({}, defaultConfig, config);
-        var id = config.id;
-        var timeoutKey = "_".concat(id, "_timeout");
-        if (window[timeoutKey]) {
-            clearTimeout(window[timeoutKey]);
-        }
-        var dom = document.getElementById(id);
-        if (!dom) {
-            dom = document.createElement('div');
-            dom.id = id;
-            dom.className = id;
-            document.body.append(dom);
-        }
-        var styleId = "".concat(id, "_style");
-        if (!document.getElementById(styleId)) {
-            var style = document.createElement('style');
-            style.id = styleId;
-            style.innerHTML = "\n            .".concat(id, " {\n                position: fixed;\n                top: calc(50vh - 60px);\n                left: calc(50vw - 60px);\n                width: 120px;\n                height: 120px;\n                z-index: 8000;\n                background: rgba(0, 0, 0, 0.6);\n                border-radius: 8px;\n                text-align: center;\n                color: white;\n                padding-top: 20px;\n            }\n            .").concat(id, " img {\n                width: 50px;\n                margin-bottom: 10px;\n            }");
-            document.head.appendChild(style);
-        }
-        dom.innerHTML = "\n            ".concat(config.hasMask ? "<div class=\"mask-wrapper\" style=\"background-color: ".concat(config.maskColor, "\"></div>") : '', "\n            <div class=\"loading-wrapper\">\n                <div class=\"loading-content\">\n                    <img src=\"//img.alicdn.com/tfs/TB1bnUsQBLoK1RjSZFuXXXn0XXa-32-32.svg\" alt=\"\u52A0\u8F7D\u4E2D\">\n                    <div>").concat(text).concat(config.cancelInline ? ' ' : '</div>', "\n                    ").concat(config.onCancel ? '<a href="javascript:;" class="cancel">取消</a>' : '', "\n                    ").concat(config.cancelInline ? '</div>' : '', "\n                </div>\n            </div>");
-        if (config.onCancel) {
-            var btn = dom.querySelector('.cancel');
-            btn && btn.addEventListener('click', function () {
-                _this.hideLoading();
-                config.onCancel();
-            });
-        }
-        dom.style.display = 'block';
-        if (seconds > 0) {
-            window[timeoutKey] = setTimeout(function () {
-                _this.hideLoading();
-            }, seconds * 1000);
-        }
-    },
-    // 隐藏全局loading
-    hideLoading: function () {
-        var id = 'com_global_page_loading';
-        var loading = document.getElementById(id);
-        if (loading) {
-            loading.style.display = 'none';
-        }
-    },
-    /**
-     * 从URL中获取某个参数，如果不存在返回 undefined ，如果存在多个同名参数，返回第一个匹配值
-     * getParam('a', '?a=1&b=&c=3&c=33#abc') // '1'
-     * getParam('b', '?a=1&b=&c=3&c=33#abc') // ''
-     * getParam('c', '?a=1&b=&c=3&c=33#abc') // 3
-     * getParam('d', '?a=1&b=&c=3&c=33#abc') // undefined
-     * @param {*} name 参数名
-     * @param {*} url 要获取的URL，默认当前地址
-     */
-    getParam: function (name, url) {
-        if (url === void 0) { url = location.search; }
-        return (new RegExp("(^|\\?|&)".concat(name, "=(.*?)(?=&|#|$)"), 'g').exec(url) || [])[2];
-    },
-    /**
-     * 从URL中获取int参数
-     * @param {*} name 参数名
-     * @param {*} url 要获取的URL，默认当前地址
-     */
-    getParamInt: function (name, url) {
-        if (url === void 0) { url = location.search; }
-        return parseInt(this.getParam(name, url) || '0', 10);
-    },
-    /**
-     * 获取某个URL的全部参数
-     * getParams('?a=1&b=2#cc') // {a: '1', b: '2'}
-     * @param url
-     * @returns 参数对象
-     */
-    getParams: function (url) {
-        if (url === void 0) { url = location.search; }
-        var search = ((url || '').split('?').pop() || '').split('#')[0] || '';
-        var params = {};
-        search.split('&').map(function (item) { return item.split('='); }).forEach(function (_a) {
-            var key = _a[0], value = _a[1];
-            params[key] = value || '';
-        });
-        return params;
-    },
-    /**
-     * 给URL设置参数，如果已经存在，替换之，兼容hash存在的情况
-     * setParam('a', '123', '?a=1&b=2&a=3#d') // '?a=123&b=2&a=123#d'
-     * setParam('d', '444', '?a=1&b=2&a=3#d') // '?a=1&b=2&a=3&d=444#d'
-     * @param {Object} name 参数名
-     * @param {Object} value 参数值
-     * @param {Object} url 如果不传默认当前页面URL
-     */
-    setParam: function (name, value, url) {
-        url = url || "".concat(location.pathname).concat(location.search);
-        // 如果参数已经存在，替换之
-        if (this.getParam(name, url) !== undefined) {
-            return url.replace(new RegExp("(^|\\?|&)".concat(name, "=(.*?)(?=&|#|$)"), 'g'), "$1".concat(name, "=").concat(value));
-        }
-        var _a = url.split('#'), pathname = _a[0], hash = _a[1]; // 处理存在hash的情况
-        return "".concat(pathname).concat(pathname.indexOf('?') < 0 ? '?' : '&').concat(name, "=").concat(value).concat(hash ? '#' : '').concat(hash || '');
-    },
-    /**
-     * 删除URL中某个参数
-     * delParam('a', '?a=1&b=2&a=3#d') // '?b=2#d'
-     * delParam('b', '?a=1&b=2&a=3#d') // '?a=1&a=3#d'
-     * delParam('a', '?a=1#d') // '#d'
-     * @param name 参数名
-     * @param url 要删除的URL，默认当前页面URL
-     * @returns 处理完后的URL
-     */
-    delParam: function (name, url) {
-        url = url || "".concat(location.pathname).concat(location.search);
-        return url.replace(new RegExp("(^|\\?|&)".concat(name, "=.*?(&|#|$)"), 'g'), function (_m, $1, $2) { return $2 === '&' ? $1 : $2; });
-    },
-    /**
-     * 休息一段时间，单位毫秒
-     * 示例：await sleep(200); // 休息200毫秒
-     * @param time 要休息的时间，单位毫秒，不传默认0
-     * @returns
-     */
-    sleep: function (time) { return new Promise(function (resolve) { return setTimeout(resolve, time || 0); }); }
-};