如何使用Word JavaScript API v1.5复制粘贴Word表格行？

要在Word JS API v1.5中复制表格行，核心是定位目标行后调用内置的复制插入方法完成操作，以下是具体实现步骤和代码示例：

核心实现逻辑 #

1. 定位目标表格和需要复制的行
2. 使用Row对象的复制插入方法生成行副本
3. 同步上下文以将更改应用到文档

代码示例 #

Word.run(async (context) => {
  // 获取文档中的目标表格（示例取第一个表格，可根据实际需求调整定位方式）
  const targetTable = context.document.tables.getItemAt(0);
  
  // 指定要复制的行索引（JS中为0起始，比如复制第3行则传入2）
  const rowToCopy = targetTable.rows.getItemAt(2);
  
  // 在目标行后方插入复制的行，若要插入到前方可改用insertCopyBefore()
  rowToCopy.insertCopyAfter();
  
  // 同步上下文，将本地操作同步到文档
  await context.sync();
  console.log("行复制操作完成");
})
.catch(error => {
  console.error("复制失败:", error);
  if (error instanceof OfficeExtension.Error) {
    console.error("错误详情:", JSON.stringify(error.debugInfo));
  }
});

关键注意事项 #

• 行索引差异：Word JS API使用0起始索引，和VBA的1起始规则不同，需注意转换
• 表格定位方式：如果目标表格不是文档第一个，可通过tables.getByRange()结合内容查找，或表格的id属性精准定位
• 自定义后续操作：若需要修改复制后的行内容，可在context.sync()后通过targetTable.rows.getItemAt(rowToCopy.index + 1)获取新插入的行进行编辑
• 异步上下文要求：所有API操作必须在Word.run()的异步上下文内执行，且必须调用context.sync()完成本地与文档的同步

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