@whitesev/utils 2.1.5 → 2.2.1

package/dist/index.umd.js

@@ -3555,7 +3555,7 @@
             this.windowApi = new WindowApi(option);
         }
         /** 版本号 */
-        version = "2024.7.24";
+        version = "2024.9.1";
         addStyle(cssText) {
             if (typeof cssText !== "string") {
                 throw new Error("Utils.addStyle 参数cssText 必须为String类型");
@@ -4939,6 +4939,19 @@
             return this.windowApi.globalThis.matchMedia("(prefers-color-scheme: dark)")
                 .matches;
         }
+        /**
+         * 判断元素是否在页面中可见
+         * @param element 需要检查的元素，可以是普通元素|数组形式的元素|通过querySelectorAll获取的元素数组
+         * @param inView
+         * + true 在窗口可视区域
+         * + false 不在窗口可视区域
+         * @returns
+         * + true 可见
+         * + false 不可见
+         * @example
+         * Utils.isVisible(document.documentElement)
+         * > true
+         */
         isVisible(element, inView = false) {
             let needCheckDomList = [];
             if (element instanceof Array || element instanceof NodeList) {
@@ -5033,39 +5046,6 @@
             });
             return result;
         }
-        listenKeyboard(target, eventName = "keypress", callback, options) {
-            if (typeof target !== "object" ||
-                (typeof target["addEventListener"] !== "function" &&
-                    typeof target["removeEventListener"] !== "function")) {
-                throw new Error("Utils.listenKeyboard 参数 target 必须为 Window|HTMLElement 类型");
-            }
-            let keyEvent = function (event) {
-                let keyName = event.key || event.code;
-                let keyValue = event.charCode || event.keyCode || event.which;
-                let otherCodeList = [];
-                if (event.ctrlKey) {
-                    otherCodeList.push("ctrl");
-                }
-                if (event.altKey) {
-                    otherCodeList.push("alt");
-                }
-                if (event.metaKey) {
-                    otherCodeList.push("meta");
-                }
-                if (event.shiftKey) {
-                    otherCodeList.push("shift");
-                }
-                if (typeof callback === "function") {
-                    callback(keyName, keyValue.toString(), otherCodeList, event);
-                }
-            };
-            target.addEventListener(eventName, keyEvent, options);
-            return {
-                removeListen() {
-                    target.removeEventListener(eventName, keyEvent);
-                },
-            };
-        }
         /**
          * 自动锁对象，用于循环判断运行的函数，在循环外new后使用，注意，如果函数内部存在异步操作，需要使用await
          * @example