如何使用Excel JavaScript API获取光标所在的活动表格及对应Range对象？

要解决这个问题，你需要切换到Excel专属的JavaScript API（而非旧的共享Office API），它提供了直接操作表格和Range的完整能力。下面是具体的实现思路和代码示例：

核心思路 #

1. 先获取当前光标选中的区域，定位其所在的工作表
2. 遍历该工作表内的所有表格，判断选中区域是否属于某个表格的范围
3. 找到目标表格后，直接获取其专属的Range对象，即可执行锁定/解锁等操作

完整代码示例 #

await Excel.run(async (context) => {
  // 1. 获取当前选中的单元格区域
  const selectedRange = context.workbook.getSelectedRange();
  selectedRange.load('worksheet');
  await context.sync();

  // 2. 获取选中区域所在工作表的所有表格
  const worksheetTables = selectedRange.worksheet.tables;
  worksheetTables.load('items');
  await context.sync();

  let activeTable = null;
  // 遍历表格，筛选出包含选中区域的表格
  for (const table of worksheetTables.items) {
    const tableFullRange = table.getRange();
    tableFullRange.load('address');
    await context.sync();

    // 检查选中区域是否与表格范围有交集
    const intersectResult = selectedRange.intersection(tableFullRange);
    intersectResult.load('address');
    await context.sync();

    if (intersectResult.address) {
      activeTable = table;
      break;
    }
  }

  if (activeTable) {
    console.log(`成功找到活动表格：${activeTable.name}`);
    
    // 3. 获取表格的Range对象并执行操作（示例：锁定表头，解锁数据区）
    // 获取表头区域并锁定
    const headerRange = activeTable.getHeaderRowRange();
    headerRange.format.protection.locked = true;

    // 获取数据区域并解锁（注意：空表格没有数据行，需判断）
    const dataRange = activeTable.getDataBodyRange();
    if (dataRange) {
      dataRange.format.protection.locked = false;
    }

    await context.sync();
    console.log("表格单元格锁定/解锁操作完成");
  } else {
    console.log("当前光标所在区域不属于任何表格");
  }
}).catch(error => {
  console.error("操作出错：", error);
});

关键说明 #

• 必须用Excel.run()包裹异步操作：这是Excel专属API的标准模式，能自动管理上下文和资源
• 每次加载对象属性后要调用await context.sync()：API采用延迟加载机制，需要同步才能获取到实际数据
• 精准操作表格区域：通过table.getRange()可获取整个表格的Range，也能用getHeaderRowRange()、getDataBodyRange()等方法定位特定区域，再通过format.protection.locked属性控制单元格锁定状态

这个方案完全避开了旧的共享TableBinding，直接使用Excel专属的Table和Range对象，完美匹配你的需求。

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