使用JavaScript API判定Excel公式R1C1或A1表示模式的可靠方案

解答 #

目前Excel JavaScript API 已原生支持获取公式引用模式，也提供兼容低版本API的替代实现方案。

1. 原生API方案（推荐） #

从Excel JS API 1.13版本开始，Application对象新增referenceStyle属性，可直接读取当前生效的公式引用模式：

• 返回值为Excel.ReferenceStyle.a1时，对应A1引用模式
• 返回值为Excel.ReferenceStyle.r1c1时，对应R1C1引用模式

示例代码：

await Excel.run(async (context) => {
  const application = context.application;
  application.load("referenceStyle");
  await context.sync();

  const currentStyle = application.referenceStyle;
  // 后续根据模式处理公式展示逻辑
})

2. 低版本API兼容方案 #

如果你的加载项需要适配1.13以下版本的Excel JS API，可通过临时写入测试公式的方式间接判断，准确率无偏差：
实现逻辑为选中用户几乎不会用到的Excel末尾单元格写入固定R1C1格式公式，读取返回的公式字符串判断模式，操作完成后清除临时内容对用户无感知。

示例代码：

async function detectReferenceStyle() {
  return Excel.run(async (context) => {
    // 选中Excel最后一个单元格（行索引1048575、列索引16383对应XFD1048576）作为临时操作对象
    const tempCell = context.workbook.getActiveWorksheet().getCell(1048575, 16383);
    // 写入引用当前单元格左上一格的R1C1格式公式
    tempCell.formula = "=R[-1]C[-1]";
    tempCell.load("formula");
    await context.sync();

    const resultStyle = tempCell.formula === "=XFC1048575" ? "A1" : "R1C1";
    // 清除临时写入的内容
    tempCell.clear();
    await context.sync();
    
    return resultStyle;
  })
}

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