如何避免SpreadJS合并行或区域内出现分页符？

一、JavaScript自定义分页逻辑（打印场景） #

SpreadJS默认打印分页不会自动识别合并单元格，需要手动计算合并区域位置，调整分页符避免拆分合并单元格：

function adjustPrintPageBreaks(spread) {
    const sheet = spread.getActiveSheet();
    const mergedAreas = sheet.getMergedAreas();
    const pageBreaks = sheet.getHorizontalPageBreaks();
    
    // 清空现有分页符，避免冲突
    pageBreaks.clear();
    
    let currentPageEndRow = 0;
    const rowCount = sheet.getRowCount();
    // 每页默认行数，可根据纸张大小、行高调整
    const pageRowLimit = 60;

    for (let i = 0; i < rowCount; i++) {
        // 检查当前行是否为某个合并区域的结束行
        const isMergedEnd = mergedAreas.some(area => {
            const mergedEndRow = area.row + area.rowCount - 1;
            return mergedEndRow === i;
        });

        // 到达页行数限制时处理分页
        if (i - currentPageEndRow >= pageRowLimit) {
            if (isMergedEnd) {
                // 在合并区域结束行下方添加分页符
                pageBreaks.add(i + 1);
                currentPageEndRow = i + 1;
            } else {
                // 向上查找最近的合并区域结束行
                let nearestMergedEnd = -1;
                mergedAreas.forEach(area => {
                    const mergedEndRow = area.row + area.rowCount - 1;
                    if (mergedEndRow > currentPageEndRow && mergedEndRow < i) {
                        nearestMergedEnd = Math.max(nearestMergedEnd, mergedEndRow);
                    }
                });
                if (nearestMergedEnd !== -1) {
                    pageBreaks.add(nearestMergedEnd + 1);
                    currentPageEndRow = nearestMergedEnd + 1;
                    i = nearestMergedEnd; // 跳至该位置继续循环
                } else {
                    // 无合并区域时直接添加分页符
                    pageBreaks.add(i + 1);
                    currentPageEndRow = i + 1;
                }
            }
        }
    }
}

// 使用方式：打印前调用
adjustPrintPageBreaks(spread);
spread.print();

二、导出Excel时的分页处理 #

导出Excel时，先调整分页符再执行导出，确保合并单元格不会被分页拆分：

function exportWithProperPageBreaks(spread) {
    const sheet = spread.getActiveSheet();
    // 先调用上面的分页调整函数
    adjustPrintPageBreaks(spread);

    // 执行Excel导出
    const json = spread.toJSON();
    GC.Spread.Sheets.IO.save(json, function(blob) {
        const a = document.createElement('a');
        a.href = URL.createObjectURL(blob);
        a.download = "output.xlsx";
        a.click();
    }, {
        fileType: GC.Spread.Sheets.FileType.excel
    });
}

三、基于自定义合并区域的解决方案（适配手动创建合并的场景） #

如果你是手动通过区域创建合并单元格，可提前存储合并区域的行范围，直接基于这些数据设置分页符：

// 假设你手动维护的合并区域行范围数组
const customMergedAreas = [
    { startRow: 5, endRow: 10 },
    { startRow: 20, endRow: 25 },
    // 其他合并区域...
];

function setPageBreaksFromCustomAreas(spread) {
    const sheet = spread.getActiveSheet();
    const pageBreaks = sheet.getHorizontalPageBreaks();
    pageBreaks.clear();
    
    let currentPageStart = 0;
    const pageRowLimit = 60;
    const rowCount = sheet.getRowCount();

    for (let i = 0; i < rowCount; i++) {
        const isEndOfMerged = customMergedAreas.some(area => area.endRow === i);

        if (i - currentPageStart >= pageRowLimit) {
            if (isEndOfMerged) {
                pageBreaks.add(i + 1);
                currentPageStart = i + 1;
            } else {
                // 查找最近的自定义合并结束行
                const nearestEnd = customMergedAreas
                    .filter(area => area.endRow > currentPageStart && area.endRow < i)
                    .sort((a, b) => b.endRow - a.endRow)[0];
                
                if (nearestEnd) {
                    pageBreaks.add(nearestEnd.endRow + 1);
                    currentPageStart = nearestEnd.endRow + 1;
                    i = nearestEnd.endRow;
                } else {
                    pageBreaks.add(i + 1);
                    currentPageStart = i + 1;
                }
            }
        }
    }
}

// 使用方式：打印/导出前调用
setPageBreaksFromCustomAreas(spread);

注意事项 #

• pageRowLimit需根据实际纸张大小、行高调整，也可通过sheet.getRowHeight(row)动态计算每页可容纳的行数，提升准确性。
• 若合并单元格动态生成，需确保customMergedAreas数组与实际合并区域同步。

内容的提问来源于stack exchange，提问作者Nacho B