@whitesev/utils 2.2.1 → 2.2.3

package/src/Utils.ts

@@ -52,7 +52,7 @@ class Utils {
 		this.windowApi = new WindowApi(option);
 	}
 	/** 版本号 */
-	version = "2024.9.1";
+	version = "2024.9.4";
 
 	/**
 	 * 在页面中增加style元素，如果html节点存在子节点，添加子节点第一个，反之，添加到html节点的子节点最后一个
@@ -864,6 +864,12 @@ class Utils {
 			| "yyyy-MM-dd"
 			| "yyyyMMdd"
 			| "HH:mm:ss"
+			| "yyyy"
+			| "MM"
+			| "dd"
+			| "HH"
+			| "mm"
+			| "ss"
 	): string;
 	formatTime(text = new Date(), formatType = "yyyy-MM-dd HH:mm:ss") {
 		let time = text == null ? new Date() : new Date(text);
@@ -2513,6 +2519,47 @@ class Utils {
 		}
 		return mutationObserver;
 	}
+	/**
+	 * 使用观察器观察元素出现在视图内，出现的话触发回调
+	 * @param target 目标元素
+	 * @param callback 触发的回调
+	 * @param options 观察器配置
+	 */
+	mutatuinVisible(
+		target: Element | Element[],
+		callback: (
+			entries: IntersectionObserverEntry[],
+			observer: IntersectionObserver
+		) => void,
+		options?: IntersectionObserverInit
+	) {
+		if (typeof IntersectionObserver === "undefined") {
+			throw new TypeError("IntersectionObserver is not defined");
+		}
+		if (target == null) {
+			throw new TypeError("mutatuinVisible target is null");
+		}
+		let defaultOptions: IntersectionObserverInit = {
+			root: null,
+			rootMargin: "0px 0px 0px 0px",
+			threshold: [0.01, 0.99],
+		};
+		defaultOptions = this.assign(defaultOptions, options || {});
+		let intersectionObserver = new IntersectionObserver((entries, observer) => {
+			if (entries[0].isIntersecting) {
+				if (typeof callback === "function") {
+					callback(entries, observer);
+				}
+			}
+		}, defaultOptions);
+		if (Array.isArray(target)) {
+			target.forEach((item) => {
+				intersectionObserver.observe(item);
+			});
+		} else {
+			intersectionObserver.observe(target);
+		}
+	}
 	/**
 	 * 去除全局window下的Utils，返回控制权
 	 * @example