rapid-spreadjs 1.0.19 → 1.0.20

package/dist/utils/sheet.d.ts

@@ -16,7 +16,16 @@ export declare const SheetUtils: {
      */
     setActiveSheetSelectCells: (spread: any, cellObj: CellModel) => void;
     /**
-     * 获取某工作表中某范围集合中所有的单元格坐标对象集合
+     * 获取某工作表中某个范围中所有的单元格坐标对象集合
+     * 该方法适用的场景如：手动选择了某个单元格范围，在这个范围中可能包含独立的单元格，也可能包含合并的单元格，这时候就需要用到如下方法获取到所有单元格对象
+     * @param sheet 工作表实例
+     * @param selectRange 单元格范围，格式如：{ row: 0, col: 0, rowCount: 2, colCount: 2 }
+     * @param isMulColOrder 是否按照多列的顺序排序单元格（true：按照第一列从上到下、第二列从上到下……的顺序获取单元格数据、false：按照第一行从左到右、第二行从左到右……的顺序获取单元格数据）
+     * @returns 返回数组集合，格式如：[{ row: 0, col: 0, rowCount: 1, colCount: 1 }]
+     */
+    getAllCellObjsByRange: (sheet: any, selectRange: CellModel, isMulColOrder?: boolean) => CellModel[];
+    /**
+     * 获取某工作表中多个范围集合中所有的单元格坐标对象集合
      * 该方法适用的场景如：手动选择了很多个单元格范围，在这些范围中可能包含独立的单元格，也可能包含合并的单元格，这时候就需要用到如下方法获取到所有单元格对象
      * @param sheet 工作表实例
      * @param selectRanges 单元格范围集合，格式如：[{ row: 0, col: 0, rowCount: 2, colCount: 2 }]
@@ -60,6 +69,15 @@ export declare const SheetUtils: {
      * @returns 返回选中单元格的值集合
      */
     getActiveSheetSelectVals: (spread: any, isMulColOrder?: boolean, nullUndefinedReplaceVal?: number | string) => (number | string | null | undefined)[];
+    /**
+     * 获取某工作表指定范围单元格的值集合（二维数组，格式如：[[1,2,3],[4,5,6]]）
+     * @param sheet 工作表实例
+     * @param cellRange 单元格范围
+     * @param groupType 分组字段属性（row或col），默认为：row
+     * @param nullUndefinedReplaceVal 如果单元格的值为null或undefined，则将其替换为该值（如果不传入该参数，则不替换）
+     * @returns 返回某工作表指定范围单元格的值集合（二维数组，格式如：[[1,2,3],[4,5,6]]）
+     */
+    getSheetRangeValsByGroup: (sheet: any, cellRange: CellModel, groupType?: "row" | "col", nullUndefinedReplaceVal?: number | string | boolean) => Array<Array<any>>;
     /**
      * 获取单元格类型名称
      * @param GC GC对象

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rapid-spreadjs",
-  "version": "1.0.19",
+  "version": "1.0.20",
   "description": "SpreadJS常用公用处理函数，包括设计器、工作簿和工作表的相关处理函数。",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
@@ -36,6 +36,6 @@
     "echarts": "^5.6.0",
     "file-saver": "^2.0.5",
     "mathjs": "^14.5.2",
-    "rapid-utils": "^1.0.19"
+    "rapid-utils": "^1.0.20"
   }
 }