lyb-pixi-js 1.12.16 → 1.12.18

package/Utils/LibPixiArrangeLinear.d.ts

@@ -1,10 +1,16 @@
-import { Container } from "pixi.js";
+import type { Container } from "pixi.js";
 /**
- * @description 按照指定方向（水平或垂直）排列元素，支持固定间隔或自定义每个间隔。
- * @param items 要排列的元素数组。
- * @param gap 元素之间的间隔，可以是固定间隔或自定义的间隔数组。
- * @param direction 排列方向，"x"表示水平，"y"表示垂直，默认为水平。
- * @param cols 列数，默认为元素数量。
- * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiArrangeLinear-间隔布局
+ * @description 线性排列 PIXI.Container 元素（支持横向/纵向排列，多列布局、固定或自定义间隔）
+ * @param items 需要排列的容器数组
+ * @param gap 间隔，可为固定值或数组（数组长度必须等于 items.length - 1）
+ * @param direction 排列方向："x" 横向排列，"y" 纵向排列
+ * @param cols 每行（或每列）最多的元素个数，默认为 Infinity（单行/单列）
+ * @example
+ * // 横向排列
+ * LibPixiArrangeLinear([sprite1, sprite2, sprite3], 10, "x");
+ * // 纵向排列
+ * LibPixiArrangeLinear([sprite1, sprite2, sprite3], 20, "y");
+ * // 两列布局
+ * LibPixiArrangeLinear([sprite1, sprite2, sprite3, sprite4], 10, "x", 2);
  */
 export declare const LibPixiArrangeLinear: (items: Container[], gap: number | number[], direction?: "x" | "y", cols?: number) => void;

package/Utils/LibPixiArrangeLinear.js

@@ -1,44 +1,61 @@
 /**
- * @description 按照指定方向（水平或垂直）排列元素，支持固定间隔或自定义每个间隔。
- * @param items 要排列的元素数组。
- * @param gap 元素之间的间隔，可以是固定间隔或自定义的间隔数组。
- * @param direction 排列方向，"x"表示水平，"y"表示垂直，默认为水平。
- * @param cols 列数，默认为元素数量。
- * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiArrangeLinear-间隔布局
+ * @description 线性排列 PIXI.Container 元素（支持横向/纵向排列，多列布局、固定或自定义间隔）
+ * @param items 需要排列的容器数组
+ * @param gap 间隔，可为固定值或数组（数组长度必须等于 items.length - 1）
+ * @param direction 排列方向："x" 横向排列，"y" 纵向排列
+ * @param cols 每行（或每列）最多的元素个数，默认为 Infinity（单行/单列）
+ * @example
+ * // 横向排列
+ * LibPixiArrangeLinear([sprite1, sprite2, sprite3], 10, "x");
+ * // 纵向排列
+ * LibPixiArrangeLinear([sprite1, sprite2, sprite3], 20, "y");
+ * // 两列布局
+ * LibPixiArrangeLinear([sprite1, sprite2, sprite3, sprite4], 10, "x", 2);
  */
 export const LibPixiArrangeLinear = (items, gap, direction = "x", cols = Infinity) => {
+    // 验证 gap 数组长度是否正确
     if (Array.isArray(gap)) {
         if (gap.length !== items.length - 1) {
             console.error(new Error("间隔的数组长度只能等于元素数组长度-1"));
             return;
         }
     }
-    let lastRowMax = 0; // 记录当前行/列最大高度或宽度
-    let rowOffset = 0; // 累计偏移量（多行时用）
+    let lastRowMax = 0; // 当前行（或列）的最大高度（或宽度），用于多行/多列换行时计算偏移
+    let rowOffset = 0; // 累计偏移量，控制换行后的整体偏移位置
     items.forEach((item, index) => {
         var _a, _b;
-        const row = Math.floor(index / cols);
-        const col = index % cols;
+        const row = Math.floor(index / cols); // 当前行号
+        const col = index % cols; // 当前列号
         if (direction === "x") {
+            //间隔
             const gapValue = Array.isArray(gap) ? (_a = gap[index - 1]) !== null && _a !== void 0 ? _a : 0 : gap;
+            //在每行第一列重置列偏移量
             if (col === 0 && row > 0) {
                 rowOffset += lastRowMax + gapValue;
                 lastRowMax = 0;
             }
+            // 横向位置 = 前一个元素的右侧 + 间隔；首列则从 0 开始
             item.x =
                 col === 0 ? 0 : items[index - 1].x + items[index - 1].width + gapValue;
-            item.y = rowOffset;
+            // 纵向位置 = 当前累计的行偏移
+            rowOffset && (item.y = rowOffset);
+            // 更新当前行的最大高度
             lastRowMax = Math.max(lastRowMax, item.height);
         }
         else {
+            //间隔
             const gapValue = Array.isArray(gap) ? (_b = gap[index - 1]) !== null && _b !== void 0 ? _b : 0 : gap;
+            //在每列第一行重置行偏移
             if (col === 0 && row > 0) {
                 rowOffset += lastRowMax + gapValue;
                 lastRowMax = 0;
             }
+            // 纵向位置 = 首列则从 0 开始，其余从前一个元素的y坐标 + 高度 + 间隔；
             item.y =
                 col === 0 ? 0 : items[index - 1].y + items[index - 1].height + gapValue;
-            item.x = rowOffset;
+            // 横向位置 = 当前累计的列偏移
+            rowOffset && (item.x = rowOffset);
+            // 更新当前列的最大宽度
             lastRowMax = Math.max(lastRowMax, item.width);
         }
     });

package/Utils/LibPixiDialogManager/ui/LibPixiDialog.d.ts

@@ -31,7 +31,7 @@ export declare class LibPixiDialog extends LibPixiBaseContainer {
     /** @description 设置弹窗内容 */
     setDialogContent(content: Container): void;
     /** @description 重绘弹窗 */
-    redraw(w: number, h: number): void;
+    redraw(w?: number, h?: number): void;
     /** @description 关闭 */
     close(): Promise<void>;
 }

package/Utils/LibPixiDialogManager/ui/LibPixiDialog.js

@@ -46,9 +46,7 @@ export class LibPixiDialog extends LibPixiBaseContainer {
     /** @description 设置弹窗内容 */
     setDialogContent(content) {
         this._dialogContainer.addChild(content);
-        const w = this._dialogContainer.width / 2;
-        const h = this._dialogContainer.height / 2;
-        this._dialogContainer.pivot.set(w, h);
+        this.redraw();
         this._dialogContainer.scale.set(0);
         this._dialogContainer.alpha = 0;
         gsap.to(this._maskUI, {
@@ -61,7 +59,10 @@ export class LibPixiDialog extends LibPixiBaseContainer {
         });
     }
     /** @description 重绘弹窗 */
-    redraw(w, h) {
+    redraw(w = window.innerWidth, h = window.innerHeight) {
+        const dialogW = this._dialogContainer.width / 2;
+        const dialogH = this._dialogContainer.height / 2;
+        this._dialogContainer.pivot.set(dialogW, dialogH);
         const halfW = 1920 / 2;
         const halfH = 1080 / 2;
         if (w > h) {

package/lyb-pixi.js

@@ -55129,7 +55129,7 @@ void main(void){
           lastRowMax = 0;
         }
         item.x = col === 0 ? 0 : items[index - 1].x + items[index - 1].width + gapValue;
-        item.y = rowOffset;
+        rowOffset && (item.y = rowOffset);
         lastRowMax = Math.max(lastRowMax, item.height);
       } else {
         const gapValue = Array.isArray(gap) ? gap[index - 1] ?? 0 : gap;
@@ -55138,7 +55138,7 @@ void main(void){
           lastRowMax = 0;
         }
         item.y = col === 0 ? 0 : items[index - 1].y + items[index - 1].height + gapValue;
-        item.x = rowOffset;
+        rowOffset && (item.x = rowOffset);
         lastRowMax = Math.max(lastRowMax, item.width);
       }
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lyb-pixi-js",
-  "version": "1.12.16",
+  "version": "1.12.18",
   "description": "自用Pixi.JS方法库",
   "license": "ISC",
   "exports": {