如何通过Word JavaScript加载项获取样式对象及其属性？

一、直接获取指定样式的段落缩进属性 #

对应你提供的VBA代码，Word JS需通过异步API加载样式及目标属性，示例代码如下：

await Word.run(async (context) => {
  // 获取文档所有样式集合
  const styles = context.document.styles;
  styles.load("items");
  await context.sync();

  // 通过索引定位目标样式（注意JS是0起始索引，对应VBA的1起始）
  const targetStyle = styles.items[0];
  // 显式加载需要读取的段落缩进属性
  targetStyle.load("paragraphFormat/leftIndent");
  await context.sync();

  // 读取并使用缩进值，单位为磅（与VBA一致）
  const leftIndent = targetStyle.paragraphFormat.leftIndent;
  console.log("样式左缩进值：", leftIndent);
});

二、从指定范围获取应用的样式及属性 #

如果需要获取选中范围或特定文本范围的样式属性，可通过以下方式实现：

await Word.run(async (context) => {
  // 获取当前选中的文本范围（也可通过range方法指定特定范围）
  const targetRange = context.document.getSelection();
  // 加载范围应用的样式
  targetRange.load("style");
  await context.sync();

  const appliedStyle = targetRange.style;
  // 加载样式的段落缩进属性
  appliedStyle.load("paragraphFormat/leftIndent");
  await context.sync();

  console.log("选中范围样式的左缩进：", appliedStyle.paragraphFormat.leftIndent);
});

关键注意事项 #

• Word JS API为异步设计，所有属性读取必须配合await context.sync()，且需显式指定要加载的属性路径（如paragraphFormat/leftIndent），默认不会自动加载所有样式属性。
• 样式索引：JS使用0起始索引，VBA为1起始，转换时需注意偏移。
• 按名称查找样式：若不想用索引，可通过遍历样式集合匹配名称：

  const targetStyle = styles.items.find(style => style.name === "正文");
  

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