rapid-spreadjs 1.0.39 → 1.0.40

package/dist/index.esm.js

@@ -573,6 +573,58 @@ const SheetUtils = {
         // // 或者使用SpreadJS提供的方法rangeToFormula
         // return GC.Spread.Sheets.CalcEngine.rangeToFormula(cellRange);
     },
+    /**
+     * 获取工作表中所有纯值或公式单元格的范围选择字符串
+     * @param sheet 工作表对象
+     * @param isFormulaCells 是否获取公式单元格，默认为：false
+     */
+    getCellsRangeStr: (sheet, isFormulaCells = false) => {
+        const range = { row: 0, col: 1, rowCount: sheet.getRowCount(), colCount: 77 };
+        // 所有单元格对象集合
+        const allCells = SheetUtils.getAllCellObjsByRanges(sheet, [range]);
+        // 最终需要的单元格对象集合
+        let retCells = [];
+        // 遍历所有单元格
+        allCells.forEach((cell) => {
+            const value = sheet.getValue(cell.row, cell.col);
+            const formula = sheet.getFormula(cell.row, cell.col);
+            // 非公式+有值（非空） ||  公式
+            if ((!isFormulaCells && !formula && value !== null && value !== undefined && value !== '') || (isFormulaCells && formula)) {
+                retCells.push(cell);
+            }
+        });
+        // 辅助函数：将列索引转为大写字母（如 0->A, 1->B, 26->AA）
+        const indexToAlpha = (index) => {
+            let alpha = '';
+            while (index >= 0) {
+                alpha = String.fromCharCode(65 + (index % 26)) + alpha;
+                index = Math.floor(index / 26) - 1;
+                if (index < 0)
+                    break;
+            }
+            return alpha;
+        };
+        // Sheet名称
+        const sheetName = sheet.name();
+        // 处理每个单元格/区域
+        const cellStrings = retCells.map((cell) => {
+            // 起始列字母
+            const colAlpha = indexToAlpha(cell.col);
+            // 起始行号（从1计数）
+            const startRow = cell.row + 1;
+            // 合并单元格只返回左上角单元格
+            const isMerged = cell.rowCount > 1 || cell.colCount > 1;
+            // 处理区域范围（合并单元格只返回左上角）
+            if (isMerged) {
+                return `${sheetName}!${colAlpha}${startRow}`;
+            }
+            // 处理单单元格
+            else {
+                return `${sheetName}!${colAlpha}${startRow}`;
+            }
+        });
+        return '=' + cellStrings.join(',');
+    },
 };
 
 /**