ph-utils 0.12.5 → 0.12.7

package/lib/dom.d.ts

@@ -33,6 +33,15 @@ export declare function create(tag: string, option?: {
     outerHTML?: string;
     [index: string]: any;
 }, ctx?: DocumentContext): HTMLElement;
+/** 创建节点 */
+export declare function $$(tag: string, option?: {
+    class?: FormatClassParam;
+    style?: FormatStyleParam;
+    textContent?: string;
+    innerHTML?: string;
+    outerHTML?: string;
+    [index: string]: any;
+}, ctx?: DocumentContext): HTMLElement;
 /**
  * 根据选择器获取匹配的第一个 DOM 元素。
  * @param selector - 选择器字符串或直接的 HTMLElement。

package/lib/dom.js

@@ -67,6 +67,10 @@ export function create(tag, option = {}, ctx) {
     }
     return $el;
 }
+/** 创建节点 */
+export function $$(tag, option = {}, ctx) {
+    return create(tag, option, ctx);
+}
 /**
  * 根据选择器获取匹配的第一个 DOM 元素。
  * @param selector - 选择器字符串或直接的 HTMLElement。

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.5",
+  "version": "0.12.7",
   "type": "module",
   "repository": {
     "type": "git",