@whitesev/utils 2.1.5 → 2.2.1

package/dist/index.esm.js

@@ -3549,7 +3549,7 @@ class Utils {
         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类型");
@@ -4933,6 +4933,19 @@ class Utils {
         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) {
@@ -5027,39 +5040,6 @@ class Utils {
         });
         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