React Excel Add-in开发：如何取消隐藏Excel行且不展开分组行

问题出在range.rowHidden=false会强制取消所有行的隐藏状态，包括那些因分组折叠而被隐藏的行。要实现只取消手动隐藏的行、保留分组折叠状态，核心是区分两种隐藏类型，只对非分组导致的隐藏行执行操作。

实现思路 #

1. 区分两种隐藏行：
   • 手动隐藏行：行本身被设置为隐藏，与分组状态无关
   • 分组折叠隐藏行：行属于某个折叠的分组，因分组收起而被隐藏
2. 先收集所有折叠分组覆盖的行范围，再遍历行，仅对不在该范围内的隐藏行取消隐藏

代码示例 #

async function unhideManualHiddenRowsOnly() {
  await Excel.run(async (context) => {
    // 获取当前活动工作表
    const activeSheet = context.workbook.worksheets.getActiveWorksheet();
    // 获取工作表已用区域的所有行
    const usedRows = activeSheet.getUsedRange().rows;
    // 加载行的隐藏状态和索引信息
    usedRows.load("rowHidden, rowIndex");

    // 获取工作表所有行分组的信息（起始行、结束行、是否折叠）
    const rowGroups = activeSheet.rowGroups.load("startRow, endRow, collapsed");
    await context.sync();

    // 存储所有因分组折叠而被隐藏的行号（Excel行号为1-based）
    const collapsedGroupRowNumbers = new Set();
    rowGroups.items.forEach(group => {
      if (group.collapsed) {
        // 将分组内的每一行行号加入集合
        for (let rowNum = group.startRow; rowNum <= group.endRow; rowNum++) {
          collapsedGroupRowNumbers.add(rowNum);
        }
      }
    });

    // 遍历所有行，仅取消非分组折叠导致的隐藏行
    usedRows.items.forEach(row => {
      // API中row.rowIndex是0-based，转换为1-based行号
      const worksheetRowNum = row.rowIndex + 1;
      if (row.rowHidden && !collapsedGroupRowNumbers.has(worksheetRowNum)) {
        row.rowHidden = false;
      }
    });

    await context.sync();
  }).catch(error => {
    console.error("取消隐藏行失败:", error);
  });
}

代码说明 #

• 行索引转换：Excel JavaScript API中row.rowIndex是0-based，而分组的startRow/endRow是1-based，因此需要加1转换为工作表实际行号
• 分组行集合：通过Set存储折叠分组覆盖的行号，实现O(1)时间复杂度的查找，提升效率
• 嵌套分组兼容：无论分组是否嵌套，只要是折叠状态，其覆盖的行都会被加入集合，不会被误取消隐藏
• 范围自定义：如果不需要处理整个已用区域，可将getUsedRange()替换为你需要操作的特定range对象

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