ph-utils 0.17.2 → 0.18.0

package/lib/dom.d.ts

@@ -75,6 +75,18 @@ export declare function hasClass(elem: HTMLElement, clazz: string): boolean;
  * @param clazz - 要切换的类名。
  */
 export declare function toggleClass(el: HTMLElement, clazz: string): void;
+/**
+ * 替换指定元素的 CSS 类
+ *
+ * 该函数用于根据给定的旧类名或类索引，将其替换为新类名。
+ * 如果旧类不存在，则不会进行替换。
+ *
+ * @param el - 目标 HTML 元素，将对其类进行操作
+ * @param oldClazz - 要替换的旧类名或类索引（基于数字时对应 classList 的索引位置）
+ * @param newClazz - 新的类名，用于替换旧的类
+ * @returns void
+ */
+export declare function replaceClass(el: HTMLElement, oldClazz: string | number, newClazz: string): void;
 type EventHandler = EventListenerOrEventListenerObject | ((e: CustomEvent) => void);
 /**
  * 为节点添加事件处理

package/lib/dom.js

@@ -124,6 +124,25 @@ export function toggleClass(el, clazz) {
         addClass(el, clazz);
     }
 }
+/**
+ * 替换指定元素的 CSS 类
+ *
+ * 该函数用于根据给定的旧类名或类索引，将其替换为新类名。
+ * 如果旧类不存在，则不会进行替换。
+ *
+ * @param el - 目标 HTML 元素，将对其类进行操作
+ * @param oldClazz - 要替换的旧类名或类索引（基于数字时对应 classList 的索引位置）
+ * @param newClazz - 新的类名，用于替换旧的类
+ * @returns void
+ */
+export function replaceClass(el, oldClazz, newClazz) {
+    // 判断 oldClazz 是否为数字，若是则通过索引从 el.classList 中获取对应类名，否则直接使用字符串值
+    let old = typeof oldClazz === "number" ? el.classList.item(oldClazz) : oldClazz;
+    // 如果旧类存在，则使用 classList.replace 方法进行替换
+    if (old) {
+        el.classList.replace(old, newClazz);
+    }
+}
 /**
  * 为节点添加事件处理
  * @param {HTMLElement} element   添加事件的节点

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ph-utils",
-  "version": "0.17.2",
+  "version": "0.18.0",
   "description": "js 开发工具集，前后端都可以使用(commonjs和es module)",
   "keywords": [
     "date",