ph-utils 0.8.1 → 0.8.2

package/lib/array.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 数组排序
+ * @param arr 待排序数组
+ * @param order 排序信息, asc - 升序, desc - 倒序
+ * @param orderKey 如果是个对象数组，按哪个字段排序
+ * @returns
+ */
+export declare function order<T>(arr: T[], order?: "asc" | "desc", orderKey?: string | null): T[];
+/**
+ * 多个数组取交集, 通常用于字符串或者数字数组
+ * @param arrs 待取交集的多个数组
+ * @returns
+ */
+export declare function intersection<T>(...arrs: T[][]): T[];

package/lib/array.js

@@ -0,0 +1,35 @@
+/**
+ * 数组排序
+ * @param arr 待排序数组
+ * @param order 排序信息, asc - 升序, desc - 倒序
+ * @param orderKey 如果是个对象数组，按哪个字段排序
+ * @returns
+ */
+export function order(arr, order = "asc", orderKey = null) {
+    const collator = new Intl.Collator();
+    return arr.sort((a, b) => {
+        let aValue = a, bValue = b;
+        if (typeof a === "object" && orderKey != null) {
+            // @ts-ignore
+            aValue = a[orderKey];
+            // @ts-ignore
+            bValue = b[orderKey];
+        }
+        let aGtb = -1;
+        if (typeof aValue === "string") {
+            aGtb = collator.compare(aValue, bValue);
+        }
+        else {
+            aGtb = aValue >= bValue ? 1 : -1;
+        }
+        return order === "asc" ? aGtb : -aGtb;
+    });
+}
+/**
+ * 多个数组取交集, 通常用于字符串或者数字数组
+ * @param arrs 待取交集的多个数组
+ * @returns
+ */
+export function intersection(...arrs) {
+    return arrs.reduce((acc, cur) => acc.filter((x) => cur.includes(x)));
+}

package/lib/date.d.ts

@@ -37,7 +37,7 @@ export declare function endOf(date?: Date | string | number, unit?: string): Dat
  * @param pre 精度, s - 精确到秒, ms - 精确到毫秒, 默认: s
  * @returns
  */
-export declare function timeStamp(ctime?: Date | string | number, pre?: "s" | "ms"): number;
+export declare function timestamp(ctime?: Date | string | number, pre?: "s" | "ms"): number;
 /**
  * 日期加上指定时间后的日期
  * @param date 指定的日期
@@ -57,5 +57,10 @@ export declare function add(date: Date | string | number | null, num: number, un
  * @param num     需要添加的数字, 如果这个参数传递一个小于0的数字，则就是日期减去相应的数字
  * @param unit    需要添加的单位，date - 加减天数
  * @param fmt     如果传递了格式化的单位，则返回格式化后的日期, 格式化字符串 yyyy - 年, mm - 月, dd - 日, HH - 小时, MM - 分钟, ss - 秒
+ *
+ * #### 1. 前一天的日期字符串形式
+ * ```javascript
+ * add(new Date(), -1, 'Date', 'yyyy-mm-dd')
+ * ```
  */
 export declare function add(date: Date | string | number | null, num: number, unit: string, fmt: string): string;

package/lib/date.js

@@ -61,7 +61,7 @@ function getUnit(unit) {
  * @param month 月份, 如果不传, 则当前月的最后一天
  * @returns
  */
-function getLastDayOfYear(date, month) {
+function getLastDayOfMonth(date, month) {
     // 获取下个月的第一天
     const lastDate = new Date(date.getFullYear(), (month || date.getMonth()) + 1, 1);
     // 将下个月的第一天的日期减去一天，得到当前月的最后一天
@@ -154,7 +154,7 @@ export function dateOf(date, unit, isEnd = false) {
         let value = setValues[index];
         if (value === -2) {
             // 设置为某个月的最后一天的日期
-            value = getLastDayOfYear(clone);
+            value = getLastDayOfMonth(clone);
         }
         Date.prototype["set" + periods[index]].apply(clone, [
             setValues[index],
@@ -186,7 +186,7 @@ export function endOf(date, unit) {
  * @param pre 精度, s - 精确到秒, ms - 精确到毫秒, 默认: s
  * @returns
  */
-export function timeStamp(ctime, pre = "s") {
+export function timestamp(ctime, pre = "s") {
     let tm = parse(ctime).getTime();
     return pre === "s" ? Math.floor(tm / 1000) : tm;
 }

package/lib/dom.d.ts

@@ -98,4 +98,13 @@ export declare function queryHideNodeSize(hideNode: string | HTMLElement, parent
  * @param direction 检查的方向，默认为"horizontal"
  * @returns 如果元素在父元素的可视区域内，则返回true；否则返回false。
  */
-export declare function isVisible(el: HTMLElement, parent?: HTMLElement, direction?: string): boolean;
+export declare function isVisible(el: HTMLElement, parent?: HTMLElement | null | undefined, direction?: string): boolean;
+/**
+ * 判断当前设备是否为移动设备。
+ *
+ * 本函数通过检查用户代理字符串和屏幕尺寸来判断设备是否为移动设备。
+ * 这对于需要根据设备类型进行不同布局或功能调整的应用非常有用。
+ *
+ * @returns {boolean} 如果设备是移动设备，则返回true；否则返回false。
+ */
+export declare function isMobile(): boolean;

package/lib/dom.js

@@ -196,7 +196,10 @@ export function queryHideNodeSize(hideNode, parent = document.body) {
  * @param direction 检查的方向，默认为"horizontal"
  * @returns 如果元素在父元素的可视区域内，则返回true；否则返回false。
  */
-export function isVisible(el, parent = document.body, direction = "horizontal") {
+export function isVisible(el, parent = null, direction = "horizontal") {
+    if (parent == null) {
+        parent = el.offsetParent;
+    }
     // 获取父元素的边界信息
     const containerRect = parent.getBoundingClientRect();
     // 获取元素的边界信息
@@ -213,3 +216,24 @@ export function isVisible(el, parent = document.body, direction = "horizontal")
     // 判断元素是否完全在容器的可视区域内
     return elStart >= containerStart && elEnd <= containerEnd;
 }
+/**
+ * 判断当前设备是否为移动设备。
+ *
+ * 本函数通过检查用户代理字符串和屏幕尺寸来判断设备是否为移动设备。
+ * 这对于需要根据设备类型进行不同布局或功能调整的应用非常有用。
+ *
+ * @returns {boolean} 如果设备是移动设备，则返回true；否则返回false。
+ */
+export function isMobile() {
+    // 通过正则表达式匹配用户代理字符串，判断是否为移动设备
+    // 检查是否为移动设备
+    const isMobile = /Mobi|Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent);
+    // 获取窗口的 innerWidth 和 innerHeight，用于判断屏幕尺寸
+    // 获取屏幕宽度和高度
+    const screenWidth = window.innerWidth;
+    const screenHeight = window.innerHeight;
+    // 判断屏幕宽度或高度是否小于等于800或600，用于进一步确认是否为移动设备
+    const isScreenMobile = screenWidth <= 800 || screenHeight <= 600;
+    // 如果是移动设备或屏幕尺寸符合移动设备特征，则返回true
+    return isMobile || isScreenMobile;
+}

package/package.json

@@ -50,9 +50,17 @@
       "types": "./lib/color.d.ts",
       "import": "./lib/color.js"
     },
+    "./logger": {
+      "types": "./lib/logger.d.ts",
+      "import": "./lib/logger.js"
+    },
+    "./array": {
+      "types": "./lib/array.d.ts",
+      "import": "./lib/array.js"
+    },
     "./*": "./lib/*"
   },
-  "version": "0.8.1",
+  "version": "0.8.2",
   "type": "module",
   "repository": {
     "type": "git",