ph-utils 0.12.4 → 0.12.6

package/lib/dom.d.ts

@@ -92,9 +92,10 @@ export declare function off(el: HTMLElement | ShadowRoot | Document, listener: s
  *
  * @param e - 触发的事件对象
  * @param eventFlag - 需要检查的属性名
+ * @param endRoot - 可选，如果传递该参数，则表示停止遍历的节点，如果未传递，则表示遍历到文档根节点为止
  * @returns 包含三个元素的数组：[是否继续传递事件, 属性值, 当前检查的DOM节点]
  */
-export declare function shouldEventNext(e: Event, eventFlag: string): (string | boolean | HTMLElement)[];
+export declare function shouldEventNext(e: Event, eventFlag: string, endRoot?: HTMLElement | ShadowRoot): [boolean, string, HTMLElement];
 /**
  * 设置或获取节点的 innerHTML 属性
  * @param element

package/lib/dom.js

@@ -149,25 +149,26 @@ export function off(el, listener, fn, option) {
  *
  * @param e - 触发的事件对象
  * @param eventFlag - 需要检查的属性名
+ * @param endRoot - 可选，如果传递该参数，则表示停止遍历的节点，如果未传递，则表示遍历到文档根节点为止
  * @returns 包含三个元素的数组：[是否继续传递事件, 属性值, 当前检查的DOM节点]
  */
-export function shouldEventNext(e, eventFlag) {
+export function shouldEventNext(e, eventFlag, endRoot) {
     let target = e.target;
     let flag = "";
     do {
-        try {
+        if ((endRoot && endRoot.isSameNode(target)) || target.tagName === "BODY") {
+            break;
+        }
+        if (target.getAttribute) {
             flag = target.getAttribute(eventFlag) || "";
-            if (flag === "") {
-                target = target.parentNode;
-                if (!target)
-                    break;
-            }
         }
-        catch (_error) {
-            break;
+        if (flag === "") {
+            target = target.parentNode;
         }
+        if (!target)
+            break;
     } while (flag === "");
-    return [flag !== "__stop__", flag, target];
+    return [flag !== "__stop__" && flag !== "", flag, target];
 }
 /**
  * 设置或获取节点的 innerHTML 属性

package/lib/index.d.ts

@@ -14,8 +14,8 @@ export declare function shieldMobile(mobile: string): string;
  * 验证参数是否是数字
  * @param str 待验证的字符串
  * @param numericParam 通过参数标记是否包含小数、正数
- * @param numericParam.isPositive 是否是正数
- * @param numericParam.isFloat 是否是小数
+ * @param numericParam.isPositive 是否是正数, 默认: false
+ * @param numericParam.isFloat 是否是小数, 默认: true
  * @returns true 是数字, false 不是数字
  */
 export declare function isNumeric(str: string, numericParam?: {

package/lib/index.js

@@ -37,8 +37,8 @@ export function shieldMobile(mobile) {
  * 验证参数是否是数字
  * @param str 待验证的字符串
  * @param numericParam 通过参数标记是否包含小数、正数
- * @param numericParam.isPositive 是否是正数
- * @param numericParam.isFloat 是否是小数
+ * @param numericParam.isPositive 是否是正数, 默认: false
+ * @param numericParam.isFloat 是否是小数, 默认: true
  * @returns true 是数字, false 不是数字
  */
 export function isNumeric(str, numericParam) {

package/lib/theme.d.ts

@@ -4,13 +4,14 @@ export declare function getSystemTheme(): "dark" | "light" | "auto";
  * 初始化主题, 让网页能够适应系统主题, 同时根据缓存的主题切换主题
  * @returns 当前应用的主题
  */
-export declare function initTheme(): Promise<"dark" | "light" | "auto">;
+export declare function initTheme(): Promise<unknown>;
 /**
  * 切换主题, 通常用于预览
  * @param theme 切换的主题
+ * @param transition 是否使用过渡动画, 注意浏览器必须支持 document.startViewTransition, 默认: true
  * @returns 切换后的主题
  */
-export declare function toggleTheme(theme?: "light" | "dark" | "auto"): Promise<"dark" | "light" | "auto">;
+export declare function toggleTheme(theme?: "light" | "dark" | "auto", transition?: boolean): Promise<unknown>;
 /** 获取当前主题 */
 export declare function getTheme(): string;
 /**
@@ -19,7 +20,7 @@ export declare function getTheme(): string;
  * @param cache 是否缓存应用的主题, 让应用下一次启动的时候, 可以应用主题, 默认: true
  * @returns 应用的主题
  */
-export declare function applyTheme(theme?: "light" | "dark" | "auto", cache?: boolean): Promise<"dark" | "light" | "auto">;
+export declare function applyTheme(theme?: "light" | "dark" | "auto", cache?: boolean): Promise<unknown>;
 /** 获取当前主题色 */
 export declare function getColorTheme(defaultValue?: string): string | undefined;
 /**

package/lib/theme.js

@@ -33,25 +33,41 @@ export async function initTheme() {
 /**
  * 切换主题, 通常用于预览
  * @param theme 切换的主题
+ * @param transition 是否使用过渡动画, 注意浏览器必须支持 document.startViewTransition, 默认: true
  * @returns 切换后的主题
  */
-export async function toggleTheme(theme) {
-    const classList = document.documentElement.classList;
-    if (theme == null) {
-        theme = getSystemTheme();
-    }
-    if (theme === "light") {
-        classList.add("light");
-        classList.remove("dark");
-    }
-    else if (theme === "dark") {
-        classList.add("dark");
-        classList.remove("light");
-    }
-    else {
-        classList.remove("light", "dark");
-    }
-    return theme;
+export async function toggleTheme(theme, transition = true) {
+    return new Promise((resolve) => {
+        const classList = document.documentElement.classList;
+        if (theme == null) {
+            theme = getSystemTheme();
+        }
+        function updateThemeClass() {
+            if (theme === "light") {
+                classList.add("light");
+                classList.remove("dark");
+            }
+            else if (theme === "dark") {
+                classList.add("dark");
+                classList.remove("light");
+            }
+            else {
+                classList.remove("light", "dark");
+            }
+        }
+        // @ts-ignore
+        if (transition && document.startViewTransition) {
+            // @ts-ignore
+            document.startViewTransition(() => {
+                updateThemeClass();
+                resolve(theme);
+            });
+        }
+        else {
+            updateThemeClass();
+            resolve(theme);
+        }
+    });
 }
 /** 获取当前主题 */
 export function getTheme() {

package/package.json

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