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

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

一、添加算法模塊分類

該模塊主要由 WangLei802 貢獻, 添加內容如下:

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

使用方式如下:

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ù)說明： 1、arr => 簡單數(shù)組or對象數(shù)組 2、arrKey => 對象數(shù)組key 3、orderby => 排序方式（默認升序('asc')、降序（'desc'））
// 簡單數(shù)組冒泡排序 --> 升序
bubbleSort(arr); // -> [1,2,3,4,8]
// 簡單數(shù)組冒泡排序 --> 降序
bubbleSort(arr,'','desc'); // -> [8,4,3,2,1]
// 對象數(shù)組冒泡排序 注：默認升序
bubbleSort(objArr,'age'); // -> [{ name: '2', age: 12 },{ name: '3', age: 13 },{ name: '5', age: 15 }...]
// 對象數(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ù)說明： 1、arr => 簡單數(shù)組or對象數(shù)組 2、key => 可選參數(shù)對象數(shù)組key 
// 簡單數(shù)組快速排序
quickSort(arr); // -> [1,2,3,4,8]
// 對象數(shù)組快速排序
quickSort(objArr,'age'); // -> [{ name: '2', age: 12 },{ name: '3', age: 13 },{ name: '5', age: 15 }...]

二、添加幾何計算模塊分類

該模塊主要由 EasyRo 貢獻, 添加內容如下：

• coordinatesInCircle 生成圓內任意坐標
• coordinatesInRect 生成矩形內任意坐標
• judgePointInCircle 判斷一點是否在圓內

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

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

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

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

接下來我們跑一下單元測試, 對整個庫做一個全面的掃描：

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

為了方便大家更好的了解 xijs 這個庫, 我列一個完整的目錄結構供大家參考, 也可以直接用 xijs 的在線文檔中去參考學習。

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