ph-utils 0.15.2 → 0.15.4

package/lib/dom.d.ts

@@ -119,12 +119,8 @@ export declare function html(element: HTMLElement, htmlstr?: string): string | u
  * @returns
  */
 export declare function text(element: HTMLElement, textstr?: string): string | null | undefined;
-/**
- * 节点列表遍历
- * @param elems
- * @param fn 遍历到节点时的回调，回调第一个参数为遍历到的节点，第2个参数为 index；如果回调函数返回 true，则会终止遍历(break)
- */
-export declare function iterate<T>(elems: NodeList | HTMLCollection | T[], fn: (el: HTMLElement | T, index: number) => any): void;
+export declare function iterate<T>(elems: T[], fn: (el: T, index: number) => any): void;
+export declare function iterate(elems: NodeList | HTMLCollection, fn: (el: HTMLElement, index: number) => any): void;
 /**
  * 设置或获取节点 data-* 属性
  * @param elem
@@ -154,9 +150,9 @@ export declare function getAttr<T extends Record<string, string | number | boole
  */
 export declare function parent(el: HTMLElement): HTMLElement;
 /**
- * 获取隐藏节点的尺寸
+ * 获取隐藏节点的尺寸, 如果 parent 传空, 且 hideNode 为节点，则会通过修改原始样式方式计算
  * @param {string | HTMLElement} hideNode - The node to hide.
- * @param parent - 添加临时节点的父节点，默认为: body.
+ * @param parent - 添加临时节点的父节点, 如果传递 null, 则通过修改原始样式方式计算，默认为: body.
  * @returns The DOMRect of the element.
  */
 export declare function queryHideNodeSize(hideNode: string | HTMLElement, parent?: HTMLElement): {

package/lib/dom.js

@@ -128,17 +128,18 @@ export function toggleClass(el, clazz) {
  * @param {boolean}     onceOrConfig  是否是只运行一次的处理函数或者配置，其中 eventFlag 为 string，如果配置该项，则表明为委托事件
  */
 export function on(element, listener, fn, option) {
-    if (typeof option === "object" && option.eventFlag) {
-        if (element.setAttribute) {
-            element.setAttribute(option.eventFlag, "__stop__");
-        }
-    }
-    if (element.length) {
+    if (element.length != null) {
         iterate(element, (elem) => {
+            if (typeof option === "object" && option.eventFlag) {
+                elem.setAttribute(option.eventFlag, "__stop__");
+            }
             elem.addEventListener(listener, fn, option);
         });
     }
     else if (element) {
+        if (typeof option === "object" && option.eventFlag) {
+            element.setAttribute(option.eventFlag, "__stop__");
+        }
         element.addEventListener(listener, fn, option);
     }
 }
@@ -149,7 +150,7 @@ export function on(element, listener, fn, option) {
  * @param fn - 要移除的事件监听器函数。
  */
 export function off(el, listener, fn, option) {
-    if (el.length) {
+    if (el.length != null) {
         iterate(el, (elem) => {
             elem.removeEventListener(listener, fn, option);
         });
@@ -281,12 +282,29 @@ export function parent(el) {
     return el.parentNode;
 }
 /**
- * 获取隐藏节点的尺寸
+ * 获取隐藏节点的尺寸, 如果 parent 传空, 且 hideNode 为节点，则会通过修改原始样式方式计算
  * @param {string | HTMLElement} hideNode - The node to hide.
- * @param parent - 添加临时节点的父节点，默认为: body.
+ * @param parent - 添加临时节点的父节点, 如果传递 null, 则通过修改原始样式方式计算，默认为: body.
  * @returns The DOMRect of the element.
  */
 export function queryHideNodeSize(hideNode, parent = document.body) {
+    if (parent == null && typeof hideNode !== "string") {
+        // 保存原来的样式
+        const originalDisplay = hideNode.style.display;
+        const originalVisibility = hideNode.style.visibility;
+        const originalPosition = hideNode.style.position;
+        // 设置为可见但不可见状态，不影响布局
+        hideNode.style.display = "block";
+        hideNode.style.visibility = "hidden";
+        hideNode.style.position = "absolute";
+        // 读取高度
+        const rect = hideNode.getBoundingClientRect();
+        // 恢复原样式
+        hideNode.style.display = originalDisplay;
+        hideNode.style.visibility = originalVisibility;
+        hideNode.style.position = originalPosition;
+        return { width: rect.width, height: rect.height };
+    }
     // 计算折叠菜单的高度
     let $tmp = document.createElement("div");
     $tmp.style.cssText = "position:fixed;left:-1000px;top:-1000px;opacity:0;";
@@ -507,7 +525,7 @@ export function transition(el, nameOrProperties, dir = "enter", finish) {
             });
         }
     }
-    el.addEventListener("transitionend", (e) => {
+    el.addEventListener("transitionend", (_e) => {
         if (status === 0) {
             status = 1;
             if (nameClass) {

package/package.json

@@ -68,7 +68,7 @@
     },
     "./*": "./lib/*"
   },
-  "version": "0.15.2",
+  "version": "0.15.4",
   "type": "module",
   "repository": {
     "type": "git",