WordApi 1.1中font.highlightColor属性的完整枚举值在哪里查询？

数据老陈

2026-5-21

Word JavaScript API: Complete List of Allowed font.highlightColor Values

我太懂你找不到这个完整颜色列表的苦恼了——这个信息确实藏得相当深，官方文档里也没做明确的完整列举。结合我自己的开发测试经验，还有社区里的讨论，给你梳理下目前能确定的情况：

1. 支持的颜色格式范围

首先，font.highlightColor 并不局限于Word桌面版调色板里的那几种，它支持所有合法的CSS颜色值，包括：

十六进制颜色码：比如你提到的白色 #FFFFFF，还有默认高亮黄 #FFFF00、浅蓝 #ADD8E6 这类
预定义CSS颜色名称：像 'white'、'yellow'、'lightgreen' 这类直接写颜色名也能生效
RGB/RGBA格式：比如 'rgb(255, 255, 255)' 或者带透明度的 'rgba(255, 255, 0, 0.5)'（不过透明度在Word里可能会有渲染差异，建议测试）

2. 关于桌面版调色板外的颜色

你发现白色能用完全正常——API层面没有把颜色限制在桌面版的内置调色板里，只要是符合CSS规范的颜色值，几乎都能成功设置高亮。我自己测试过像淡粉 #FFE4E1、薰衣草紫 #E6E6FA 这类自定义浅色调，不管是桌面版还是网页版Word，都能正常显示。

3. 找不到官方列表的替代验证方法

既然官方文档没列全，最快的验证方式就是直接写代码测试：

await Word.run(async (context) => {
  const selectedRange = context.document.getSelection();
  selectedRange.font.highlightColor = '#FFE4E1'; // 替换成你要测试的颜色值
  await context.sync();
});

另外，font.highlightColor 和Word JS API里其他颜色属性（比如 font.color、paragraphFormat.shading.color）的颜色处理逻辑是一致的，所以如果遇到不确定的颜色，也可以参考这些属性的使用规则。