Excel JavaScript API 中是否存在在更改表名称时触发的事件？

Question

对于我正在开发的 Excel 插件，我需要知道何时更改表的名称。 Table 的“事件”部分没有onNameChanged或类似的东西。 我已经尝试过onChanged是否也涵盖了名称更改，但是在下面的代码段中，它不是由表的名称更改触发的。 片段中的其他处理程序也不会被触发。 我已经在 Office Online 和 Excel for Mac (v16.39) 中测试了该代码段。 更改表名时是否会触发另一个事件？

async function run() {
  await Excel.run(async (context) => {
    const table = context.workbook.tables.add("A1:B2", true);
    table.load('worksheet');
    await context.sync();
    const createHandler = (name) => (async () => {
      console.log(`Received event: ${name}`);
    });
    table.onChanged.add(createHandler('Table.onChanged'));
    context.workbook.tables.onChanged.add(createHandler('TableCollection.onChanged'));
    context.workbook.tables.onAdded.add(createHandler('TableCollection.onAdded'));
    context.workbook.tables.onDeleted.add(createHandler('TableCollection.onDeleted'));
    table.worksheet.onChanged.add(createHandler('Worksheet.onChanged'));
    await context.sync();
    table.name = 'TestTable';
    await context.sync();
  });
}

Answer 1

不幸的是，Office JS Excel API 目前不支持table.onNameChanged事件。 在您的要点中，您尝试使用table.onChanged ，但是table.onChanged仅在此表上的单元格中的数据发生更改时发生。

因此，我建议您可以在uservoice提交请求并对此请求进行投票，也请在此请求中分享您的场景。

Answer 2

鉴于您希望在重命名在 Excel（不是 javascript）中创建的Table时触发一个事件，并且重命名时不会触发表上假定的onChanged事件，我的 hacky 解决方法如下：

侦听Worksheet （包含[Table] ）上的onChanged事件，以便您侦听所有表数据更改。 当事件触发时，检查Table in worksheet.tables中的名称更改（与旧名称的Map比较）：

const map = new Map();
worksheet.tables.forEach((table, i) => {
    const newName = table.name;
    const key = `${worksheet.id}-${i}`;
    map.set(key, newName);
}

worksheet.onChanged.add(() => {
  worksheet.tables.forEach((table, i) => {
    const newName = table.name;
    const key = `${worksheet.id}-${i}`;
    
    let oldName;
    if (map.has(key)) {
      oldName = map.get(key);
    } else {
      map.set(key, newName);
    }

    if (oldName !== newName) {
      console.log(`Name changed from ${oldName} to ${newName}`);
      console.log(`For table ${key}`);
    }
  });
});

附带说明：您始终可以通过将 object 包装到Proxy中来监听 Javascript 的变化。 这是一个例子：

let obj = {
    name: 'harry potter',
    age: 27,
};

// we want to listen for changes on name
// so wrap object in Proxy
obj = new Proxy(obj, {
    set(obj, prop, newval) {
        if (prop === 'name') {
            // put your changing logic here
            // or fire an event listener
            console.log("Name has changed");
        }

        // default behavior to store value
        obj[prop] = newval;
        return true;
    } 
})

obj.name = 'john smith';
// outputs 'Name has changed'

在此处阅读有关代理的更多信息： https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy