xijs 是一款開箱即用的 js 業(yè)務(wù)工具庫(kù), 聚集于解決業(yè)務(wù)中遇到的常用函數(shù)邏輯問(wèn)題, 幫助開發(fā)者更高效的開展業(yè)務(wù)開發(fā)。

接下來(lái)就和大家一起分享一下v1.2.1 版本的更新內(nèi)容以及后續(xù)的更新方向。

一、添加算法模塊分類

該模塊主要由 WangLei802 貢獻(xiàn), 添加內(nèi)容如下:

• 添加冒泡排序算法及其單元測(cè)試。
• 添加快速排序算法及其單元測(cè)試。

使用方式如下:

1、冒泡排序

import { bubbleSort } from 'xijs';
let arr = [1, 3, 2, 8, 4];
let objArr = [
  { name: '8', age: 18 },
  { name: '3', age: 13 },
  { name: '5', age: 15 },
  { name: '2', age: 12 },
];
// bubbleSort(arr,arrKey,orderby)  參數(shù)說(shuō)明： 1、arr => 簡(jiǎn)單數(shù)組or對(duì)象數(shù)組 2、arrKey => 對(duì)象數(shù)組key 3、orderby => 排序方式（默認(rèn)升序('asc')、降序（'desc'））
// 簡(jiǎn)單數(shù)組冒泡排序 --> 升序
bubbleSort(arr); // -> [1,2,3,4,8]
// 簡(jiǎn)單數(shù)組冒泡排序 --> 降序
bubbleSort(arr,'','desc'); // -> [8,4,3,2,1]
// 對(duì)象數(shù)組冒泡排序 注：默認(rèn)升序
bubbleSort(objArr,'age'); // -> [{ name: '2', age: 12 },{ name: '3', age: 13 },{ name: '5', age: 15 }...]
// 對(duì)象數(shù)組冒泡排序 --> 降序
bubbleSort(objArr,'age','desc'); // -> [{ name: '8', age: 18 },{ name: '5', age: 15 },{ name: '3', age: 13 }...]

2、快速排序

import { quickSort } from 'xijs';
let arr = [1, 3, 2, 8, 4];
let objArr = [
  { name: '8', age: 18 },
  { name: '3', age: 13 },
  { name: '5', age: 15 },
  { name: '2', age: 12 },
];
// quickSort(arr,key)  參數(shù)說(shuō)明： 1、arr => 簡(jiǎn)單數(shù)組or對(duì)象數(shù)組 2、key => 可選參數(shù)對(duì)象數(shù)組key 
// 簡(jiǎn)單數(shù)組快速排序
quickSort(arr); // -> [1,2,3,4,8]
// 對(duì)象數(shù)組快速排序
quickSort(objArr,'age'); // -> [{ name: '2', age: 12 },{ name: '3', age: 13 },{ name: '5', age: 15 }...]

二、添加幾何計(jì)算模塊分類

該模塊主要由 EasyRo 貢獻(xiàn), 添加內(nèi)容如下：

• coordinatesInCircle 生成圓內(nèi)任意坐標(biāo)
• coordinatesInRect 生成矩形內(nèi)任意坐標(biāo)
• judgePointInCircle 判斷一點(diǎn)是否在圓內(nèi)

這幾個(gè)方法對(duì)于可視化項(xiàng)目的設(shè)計(jì)和開發(fā)非常有價(jià)值, 后續(xù)會(huì)在幾何計(jì)算模塊中開拓更多常用函數(shù), 供大家輕松使用. 接下來(lái)介紹一下具體用法：

import { judgePointInCircle } from 'xijs';
// 判斷中心在(3,4) 坐標(biāo)內(nèi), 半徑為5的圓上是否存在(4,6) 這個(gè)點(diǎn)
const res = judgePointInCircle(
  {
    center: [3, 4],
    r: 5,
  },
  4,
  6,
);
console.log(res); // -> true

該算法運(yùn)用了很多幾何和代數(shù)知識(shí), 我之前在設(shè)計(jì)開源項(xiàng)目vue3幾何畫板 中也使用了大量幾何判斷, 感興趣的朋友可以參考一下:

github地址: https://gitee.com/lowcode-china/euryd。

接下來(lái)我們跑一下單元測(cè)試, 對(duì)整個(gè)庫(kù)做一個(gè)全面的掃描：

整個(gè)測(cè)試一共花了10s, 測(cè)試全部通過(guò), 各位小伙伴們可以放松食用。

為了方便大家更好的了解 xijs 這個(gè)庫(kù), 我列一個(gè)完整的目錄結(jié)構(gòu)供大家參考, 也可以直接用 xijs 的在線文檔中去參考學(xué)習(xí)。

• 瀏覽器相關(guān) getRuntimeEnv - 獲取運(yùn)行環(huán)境getSelection - 獲取選中文本redirect - 重定向store - 本地存儲(chǔ)庫(kù)。
• 字符串操作 base64 - base64編碼和解碼camelize - 橫線轉(zhuǎn)駝峰命名charCount - 獲取字符數(shù)formatNumber - 數(shù)值千分位格式化formatPercent - 值轉(zhuǎn)換為百分?jǐn)?shù)表示hyCompact - 緊湊型駝峰命名轉(zhuǎn)換hyphenate - 駝峰命名轉(zhuǎn)橫線命名randomStr - 生成隨機(jī)字符串repeat - 生成重復(fù)字符串uuid - 生成唯一id。
• 常用判斷函數(shù) isArray - 判斷數(shù)組類型isEmpty - 判斷空對(duì)象isPc - 判斷設(shè)備類型isPhone - 判斷手機(jī)號(hào)格式。
• 數(shù)據(jù)結(jié)構(gòu)相關(guān) cloneDeep - 數(shù)據(jù)深拷貝formatDate - 時(shí)間格式化getRawType - 獲取數(shù)據(jù)類型obj2url - 將對(duì)象參數(shù)解析為url字符串transformTree - 扁平轉(zhuǎn)樹結(jié)構(gòu)url2obj - url字符串轉(zhuǎn)對(duì)象。
• 圖片處理函數(shù) compressImg - 自定義壓縮圖片函數(shù)file2img - 文件轉(zhuǎn)圖片對(duì)象hex2rgba - hex色值轉(zhuǎn)rgbargba2obj - 將rgba值轉(zhuǎn)化為rgba對(duì)象。
• js高級(jí)函數(shù) debounce - 防抖函數(shù)parser - json超級(jí)解析器sleep - 睡眠函數(shù)throttle - 節(jié)流函數(shù)。
• 常用算法和數(shù)據(jù)結(jié)構(gòu) bubbleSort - 冒泡排序quickSort - 快速排序。
• 數(shù)學(xué)計(jì)算 average - 計(jì)算數(shù)組平均值difference - 創(chuàng)建一個(gè)排除指定項(xiàng)的數(shù)組random - 返回區(qū)域內(nèi)隨機(jī)數(shù)shuffle - 打亂數(shù)組。
• 幾何計(jì)算 coordinatesInCircle - 生成圓內(nèi)任意坐標(biāo)coordinatesInRect - 生成矩形內(nèi)任意坐標(biāo)judgePointInCircle - 判斷一點(diǎn)是否在圓內(nèi)。