lyb-js 1.1.0 → 1.1.1

package/README.md

@@ -61,6 +61,8 @@ libJsCalculateExpression("(1+2)-(3*4)/5"); //0.6
 
 \- [LibJsTagTitleTip-网站标题交互](#LibJsTagTitleTip-网站标题交互)
 
+\- [LibJsObjToUrlParams-对象转Url参数](#LibJsObjToUrlParams-对象转Url参数)
+
 
 ### Data-数据
 
@@ -76,6 +78,8 @@ libJsCalculateExpression("(1+2)-(3*4)/5"); //0.6
 
 \- [LibJsStepArray-数组偏移](#LibJsStepArray-数组偏移)
 
+\- [LibReverseArrayFromIndex-数组定位翻转](#LibReverseArrayFromIndex-数组定位翻转)
+
 
 ### File-文件
 
@@ -117,6 +121,8 @@ libJsCalculateExpression("(1+2)-(3*4)/5"); //0.6
 
 \- [LibJsRetryRequest-请求重连](#LibJsRetryRequest-请求重连)
 
+\- [LibNumerStepper-数字步进器](#LibNumerStepper-数字步进器)
+
 
 ### Random-随机
 
@@ -217,6 +223,15 @@ libJsSetTitleIcon("我的网站", "https://example.com/favicon.ico");
 libJsTagTitleTip("欢迎回来", "来和妲己玩耍吧！");
 ```
 
+### LibJsObjToUrlParams-对象转Url参数
+
+> 将对象转为地址栏参数
+
+```js
+libJsObjToParams({ name: "John", age: 30, active: true });
+// "name=John&age=30&active=true"
+```
+
 ## Data-数据
 
 ### LibJsChunkArray-数组拆分
@@ -273,6 +288,15 @@ const moved = libJsStepArray([1, 2, 3, 4, 5], 2);
 console.log(moved); //[4, 5, 1, 2, 3]
 ```
 
+### LibReverseArrayFromIndex-数组定位翻转
+
+> 翻转指定索引后面的数组
+
+```ts
+libReverseArrayFromIndex([1, 2, 3, 4, 5], 1);
+// [1, 2, 5, 4, 3]
+```
+
 ## File-文件
 
 ### LibJsDownloadImageLink-图片下载
@@ -308,8 +332,8 @@ libJsImageOptimizerOptionsParams({
 > 保存`JSON`文件到本地，也支持保存纯文本的`txt`文件
 
 ```ts
-libJsSaveJson(JSON.stringify({ key: "value" }), "example.json");、
-libJsSaveJson("Hellow World!", "example.txt");
+libJsSaveJson("example.json", JSON.stringify({ key: "value" }));
+libJsSaveJson("example.txt", "Hellow World!");
 ```
 
 ## Formatter-格式化
@@ -417,7 +441,7 @@ libJsDecimal(10, 3, "-"); //7
 libJsDecimal(10, 3, "/", 2); //3.33
 ```
 
-## Misc
+## Misc-杂项
 
 ### LibJsRegFormValidate-表单验证
 
@@ -457,6 +481,17 @@ libJsRetryRequest({
 .catch(err => console.error(err));
 ```
 
+### LibNumerStepper-数字步进器
+
+> 通过调用方法来增加和减少数字索引
+
+```ts
+const stepper = new libNumerStepper(10, (index) => console.log(index));
+stepper.down("add"); // 索引加1
+stepper.updateIndex(5); // 更新索引为5
+stepper.down("sub"); // 索引减1
+```
+
 ## Random-随机
 
 ### LibJsProbabilityResult-概率触发

package/dist/Browser/LibJsObjToUrlParams/index.d.ts

@@ -0,0 +1,7 @@
+/** @description 将对象转为地址栏参数
+ * @param params 对象参数
+ * @example
+ * libJsObjToUrlParams({ name: "John", age: 30, active: true });
+ * // "name=John&age=30&active=true"
+ */
+export declare const libJsObjToUrlParams: (params: Record<string, string | number | boolean>) => string;

package/dist/Browser/LibJsObjToUrlParams/index.js

@@ -0,0 +1,11 @@
+/** @description 将对象转为地址栏参数
+ * @param params 对象参数
+ * @example
+ * libJsObjToUrlParams({ name: "John", age: 30, active: true });
+ * // "name=John&age=30&active=true"
+ */
+export const libJsObjToUrlParams = (params) => {
+    return Object.entries(params)
+        .map(([key, value]) => `${key}=${value}`)
+        .join("&");
+};

package/dist/Data/LibReverseArrayFromIndex/index.d.ts

@@ -0,0 +1,8 @@
+/** @description 翻转指定索引后面的数组
+ * @param arr 数组
+ * @param index 开始索引
+ * @example
+ * libReverseArrayFromIndex([1, 2, 3, 4, 5], 1);
+ * // [1, 2, 5, 4, 3]
+ */
+export declare const libReverseArrayFromIndex: <T>(arr: T[], index: number) => T[];

package/dist/Data/LibReverseArrayFromIndex/index.js

@@ -0,0 +1,14 @@
+/** @description 翻转指定索引后面的数组
+ * @param arr 数组
+ * @param index 开始索引
+ * @example
+ * libReverseArrayFromIndex([1, 2, 3, 4, 5], 1);
+ * // [1, 2, 5, 4, 3]
+ */
+export const libReverseArrayFromIndex = (arr, index) => {
+    if (index < 0 || index >= arr.length) {
+        throw new Error("Index out of bounds");
+    }
+    const subArray = arr.slice(index + 1).reverse();
+    return [...arr.slice(0, index + 1), ...subArray];
+};

package/dist/File/LibJsSaveJson/index.d.ts

@@ -1,9 +1,9 @@
 /**
  * @description 保存文件到本地
- * @param data 要保存的数据
  * @param name 文件名
+ * @param data 要保存的数据
  * @example
- * libJsSaveJson(JSON.stringify({ key: "value" }), "example.json");
- * libJsSaveJson("Hellow World!", "example.txt");
+ * libJsSaveJson("example.json", JSON.stringify({ key: "value" }));
+ * libJsSaveJson("example.txt", "Hellow World!");
  */
-export declare const libJsSaveJson: (data: BlobPart, name: string) => void;
+export declare const libJsSaveJson: (name: string, data: BlobPart) => void;

package/dist/File/LibJsSaveJson/index.js

@@ -1,12 +1,12 @@
 /**
  * @description 保存文件到本地
- * @param data 要保存的数据
  * @param name 文件名
+ * @param data 要保存的数据
  * @example
- * libJsSaveJson(JSON.stringify({ key: "value" }), "example.json");
- * libJsSaveJson("Hellow World!", "example.txt");
+ * libJsSaveJson("example.json", JSON.stringify({ key: "value" }));
+ * libJsSaveJson("example.txt", "Hellow World!");
  */
-export const libJsSaveJson = (data, name) => {
+export const libJsSaveJson = (name, data) => {
     const urlObject = window.URL || window.webkitURL;
     const exportBlob = new Blob([data]);
     const saveLink = document.createElement("a");

package/dist/Misc/LibNumerStepper/index.d.ts

@@ -0,0 +1,34 @@
+/** @description 数字步进器
+ * @example
+ * const stepper = new libNumerStepper(10, (index) => console.log(index));
+ * stepper.down("add"); // 索引加1
+ * stepper.updateIndex(5); // 更新索引为5
+ * stepper.down("sub"); // 索引减1
+ */
+export declare class libNumerStepper {
+    /** 数字变动时触发 */
+    private _onChange;
+    /** 当前按下状态 */
+    private _isDown;
+    /** 当前数字索引 */
+    private _currentIndex;
+    /** 定时器ID */
+    private _timerId;
+    /** 计时器ID */
+    private _intervalId;
+    /** 金额数 */
+    private _numsLength;
+    /**
+     * @param numsLength 数字长度
+     * @param onChange 数字变动时触发
+     */
+    constructor(numsLength: number, onChange: (index: number) => void);
+    /** @description 按下 */
+    down(type: "add" | "sub"): void;
+    /** @description 更新索引 */
+    updateIndex(index: number): void;
+    /** @description 抬起 */
+    private _up;
+    /** @description 处理数字变化 */
+    private _handleChange;
+}

package/dist/Misc/LibNumerStepper/index.js

@@ -0,0 +1,69 @@
+/** @description 数字步进器
+ * @example
+ * const stepper = new libNumerStepper(10, (index) => console.log(index));
+ * stepper.down("add"); // 索引加1
+ * stepper.updateIndex(5); // 更新索引为5
+ * stepper.down("sub"); // 索引减1
+ */
+export class libNumerStepper {
+    /** 数字变动时触发 */
+    _onChange;
+    /** 当前按下状态 */
+    _isDown = false;
+    /** 当前数字索引 */
+    _currentIndex = 0;
+    /** 定时器ID */
+    _timerId;
+    /** 计时器ID */
+    _intervalId;
+    /** 金额数 */
+    _numsLength = 0;
+    /**
+     * @param numsLength 数字长度
+     * @param onChange 数字变动时触发
+     */
+    constructor(numsLength, onChange) {
+        this._onChange = onChange;
+        this._numsLength = numsLength;
+        window.addEventListener("pointerup", () => {
+            this._isDown && this._up();
+        });
+    }
+    /** @description 按下 */
+    down(type) {
+        this._isDown = true;
+        this._handleChange(type);
+        this._timerId = setTimeout(() => {
+            if (this._isDown) {
+                this._intervalId = setInterval(() => {
+                    this._handleChange(type);
+                }, 100);
+            }
+        }, 100);
+    }
+    /** @description 更新索引 */
+    updateIndex(index) {
+        this._currentIndex = index;
+    }
+    /** @description 抬起 */
+    _up() {
+        this._isDown = false;
+        clearTimeout(this._timerId);
+        clearInterval(this._intervalId);
+    }
+    /** @description 处理数字变化 */
+    _handleChange(type) {
+        if (type === "add") {
+            if (this._currentIndex < this._numsLength - 1) {
+                this._currentIndex++;
+                this._onChange(this._currentIndex);
+            }
+        }
+        else if (type === "sub") {
+            if (this._currentIndex > 0) {
+                this._currentIndex--;
+                this._onChange(this._currentIndex);
+            }
+        }
+    }
+}

package/dist/libJs.d.ts

@@ -1,3 +1,4 @@
+import { libNumerStepper } from "./Misc/LibNumerStepper";
 /** @description 基础方法 */
 export declare const Base: {
     /**
@@ -69,6 +70,13 @@ export declare const Browser: {
      * libJsTagTitleTip("欢迎回来", "来和妲己玩耍吧！");
      */
     libJsTagTitleTip: (backTitle: string, leaveTitle: string) => void;
+    /** @description 对象转为url参数
+     * @param params 对象参数
+     * @example
+     * libJsObjToUrlParams({ name: "John", age: 30, active: true });
+     * // "name=John&age=30&active=true"
+     */
+    libJsObjToUrlParams: (params: Record<string, string | number | boolean>) => string;
 };
 /** @description 数据相关方法 */
 export declare const Data: {
@@ -122,6 +130,14 @@ export declare const Data: {
      * console.log(moved); //[4, 5, 1, 2, 3]
      */
     libJsStepArray: <T>(arr: T[], step: number) => T[];
+    /** @description 翻转指定索引后面的数组
+     * @param arr 数组
+     * @param index 开始索引
+     * @example
+     * libReverseArrayFromIndex([1, 2, 3, 4, 5], 1);
+     * // [1, 2, 5, 4, 3]
+     */
+    libReverseArrayFromIndex: <T>(arr: T[], index: number) => T[];
 };
 /** @description 文件相关方法 */
 export declare const File: {
@@ -155,9 +171,9 @@ export declare const File: {
      * @param data 要保存的数据
      * @param name 文件名
      * @example
-     * libJsSaveJson(JSON.stringify({ key: "value" }), "example.json");
+     * libJsSaveJson("example.json", JSON.stringify({ key: "value" }));
      */
-    libJsSaveJson: (data: BlobPart, name: string) => void;
+    libJsSaveJson: (name: string, data: BlobPart) => void;
 };
 /** @description 格式化相关方法 */
 export declare const Formatter: {
@@ -326,6 +342,14 @@ export declare const Misc: {
         retryDelay?: number;
         onRetry?: () => void;
     }) => Promise<T>;
+    /** @description 数字步进器
+     * @example
+     * const stepper = new libNumerStepper(10, (index) => console.log(index));
+     * stepper.down("add"); // 索引加1
+     * stepper.updateIndex(5); // 更新索引为5
+     * stepper.down("sub"); // 索引减1
+     */
+    libNumerStepper: typeof libNumerStepper;
 };
 /** @description 随机相关方法 */
 export declare const Random: {

package/dist/libJs.js

@@ -6,12 +6,14 @@ import { libJsIsPad } from "./Browser/LibJsIsPad";
 import { libJsPathParams } from "./Browser/LibJsPathParams";
 import { libJsSetTitleIcon } from "./Browser/LibJsSetTitleIcon";
 import { libJsTagTitleTip } from "./Browser/LibJsTagTitleTip";
+import { libJsObjToUrlParams } from "./Browser/LibJsObjToUrlParams";
 import { libJsChunkArray } from "./Data/LibJsChunkArray";
 import { libJsDeepJSONParse } from "./Data/LibJsDeepJSONParse";
 import { libJsGroupArrayByKey } from "./Data/LibJsGroupArrayByKey";
 import { libJsMatchEmail } from "./Data/LibJsMatchEmail";
 import { libJsShuffleArray } from "./Data/LibJsShuffleArray";
 import { libJsStepArray } from "./Data/LibJsStepArray";
+import { libReverseArrayFromIndex } from "./Data/LibReverseArrayFromIndex";
 import { libJsDownloadImageLink } from "./File/LibJsDownloadImageLink";
 import { libJsImageOptimizer } from "./File/LibJsImageOptimizer";
 import { libJsSaveJson } from "./File/LibJsSaveJson";
@@ -34,6 +36,7 @@ import { libJsUniqueRandomNumbers } from "./Random/LibJsUniqueRandomNumbers";
 import { libJsSameTimeCheck } from "./Time/LibJsSameTimeCheck";
 import { libJsTimeAgo } from "./Time/LibJsTimeAgo";
 import { libJsTimeGreeting } from "./Time/LibJsTimeGreeting";
+import { libNumerStepper } from "./Misc/LibNumerStepper";
 /** @description 基础方法 */
 export const Base = {
     /**
@@ -102,6 +105,13 @@ export const Browser = {
      * libJsTagTitleTip("欢迎回来", "来和妲己玩耍吧！");
      */
     libJsTagTitleTip,
+    /** @description 对象转为url参数
+     * @param params 对象参数
+     * @example
+     * libJsObjToUrlParams({ name: "John", age: 30, active: true });
+     * // "name=John&age=30&active=true"
+     */
+    libJsObjToUrlParams,
 };
 /** @description 数据相关方法 */
 export const Data = {
@@ -155,6 +165,14 @@ export const Data = {
      * console.log(moved); //[4, 5, 1, 2, 3]
      */
     libJsStepArray,
+    /** @description 翻转指定索引后面的数组
+     * @param arr 数组
+     * @param index 开始索引
+     * @example
+     * libReverseArrayFromIndex([1, 2, 3, 4, 5], 1);
+     * // [1, 2, 5, 4, 3]
+     */
+    libReverseArrayFromIndex,
 };
 /** @description 文件相关方法 */
 export const File = {
@@ -188,7 +206,7 @@ export const File = {
      * @param data 要保存的数据
      * @param name 文件名
      * @example
-     * libJsSaveJson(JSON.stringify({ key: "value" }), "example.json");
+     * libJsSaveJson("example.json", JSON.stringify({ key: "value" }));
      */
     libJsSaveJson,
 };
@@ -336,6 +354,14 @@ export const Misc = {
      * .catch(err => console.error(err));
      */
     libJsRetryRequest,
+    /** @description 数字步进器
+     * @example
+     * const stepper = new libNumerStepper(10, (index) => console.log(index));
+     * stepper.down("add"); // 索引加1
+     * stepper.updateIndex(5); // 更新索引为5
+     * stepper.down("sub"); // 索引减1
+     */
+    libNumerStepper,
 };
 /** @description 随机相关方法 */
 export const Random = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lyb-js",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "author": "冷弋白",
   "description": "lyb自用JS方法库",
   "license": "ISC",