使用Office JavaScript API管理Office主题强调色

Office JS原生的Office.context.officeTheme确实只暴露了主题的4种核心颜色（深色1、浅色1、深色2、浅色2），没法直接获取或修改6个强调色，而且修改操作会生成新调色板。下面是两种可行的解决思路：

一、Office JS结合OOXML的进阶方案 #

通过直接操作Office Open XML（OOXML），可以完整读写包括强调色在内的所有主题颜色，并且直接修改当前文档的调色板，不会新建。

1. 读取完整主题颜色 #

先获取当前幻灯片的OOXML，解析其中的主题部分，提取所有12种颜色：

function getFullThemeColors() {
  Office.context.document.getSelectedDataAsync(Office.CoercionType.Ooxml, (result) => {
    if (result.status === Office.AsyncResultStatus.Succeeded) {
      const ooxml = result.value;
      const parser = new DOMParser();
      const xmlDoc = parser.parseFromString(ooxml, "application/xml");
      
      // 获取颜色方案节点
      const clrScheme = xmlDoc.querySelector("a\\:clrScheme, clrScheme");
      if (clrScheme) {
        const colors = {};
        // 提取所有颜色节点（核心色+强调色+链接色）
        const colorNodes = clrScheme.querySelectorAll("a\\:dk1, a\\:lt1, a\\:dk2, a\\:lt2, a\\:accent1, a\\:accent2, a\\:accent3, a\\:accent4, a\\:accent5, a\\:accent6, a\\:hlink, a\\:folHlink");
        colorNodes.forEach(node => {
          const colorType = node.tagName.replace("a:", "");
          // 获取RGB值（兼容srgbClr类型）
          const srgbNode = node.querySelector("a\\:srgbClr, srgbClr");
          if (srgbNode) {
            colors[colorType] = srgbNode.getAttribute("val");
          }
        });
        console.log("完整主题颜色：", colors);
        // 将colors传入业务逻辑
      }
    } else {
      console.error("获取OOXML失败：", result.error.message);
    }
  });
}

2. 修改当前主题的颜色（含强调色） #

修改OOXML中的主题颜色节点后写回文档，直接更新当前调色板，不会生成新的：

function updateThemeColor(colorType, newRgbValue) {
  // 获取当前文档的压缩版OOXML
  Office.context.document.getFileAsync(Office.FileType.Compressed, { sliceSize: 1024 * 1024 }, (getFileResult) => {
    if (getFileResult.status === Office.AsyncResultStatus.Succeeded) {
      const file = getFileResult.value;
      file.getSliceAsync(0, (sliceResult) => {
        if (sliceResult.status === Office.AsyncResultStatus.Succeeded) {
          const slice = sliceResult.value;
          // 用JSZip解析ZIP格式的OOXML
          const zip = new JSZip();
          zip.loadAsync(slice.data).then((zip) => {
            // 读取主题XML文件
            zip.file("ppt/theme/theme1.xml").async("string").then((themeXml) => {
              const parser = new DOMParser();
              const xmlDoc = parser.parseFromString(themeXml, "application/xml");
              // 定位目标颜色节点
              const colorNode = xmlDoc.querySelector(`a\\:${colorType}, ${colorType}`);
              if (colorNode) {
                let srgbNode = colorNode.querySelector("a\\:srgbClr, srgbClr");
                // 若为系统颜色类型，替换为自定义RGB节点
                if (!srgbNode) {
                  const sysNode = colorNode.querySelector("a\\:sysClr, sysClr");
                  if (sysNode) colorNode.removeChild(sysNode);
                  srgbNode = xmlDoc.createElementNS("http://schemas.openxmlformats.org/drawingml/2006/main", "a:srgbClr");
                  colorNode.appendChild(srgbNode);
                }
                srgbNode.setAttribute("val", newRgbValue);
                // 写回修改后的主题XML
                zip.file("ppt/theme/theme1.xml", new XMLSerializer().serializeToString(xmlDoc));
                // 生成修改后的压缩包并上传
                zip.generateAsync({ type: "arraybuffer" }).then((updatedBuffer) => {
                  Office.context.document.putFileAsync(Office.FileType.Compressed, { sliceSize: 1024 * 1024 }, (putResult) => {
                    if (putResult.status === Office.AsyncResultStatus.Succeeded) {
                      const uploadSession = putResult.value;
                      uploadSession.setSliceAsync(0, updatedBuffer, (setSliceResult) => {
                        if (setSliceResult.status === Office.AsyncResultStatus.Succeeded) {
                          uploadSession.commitAsync((commitResult) => {
                            commitResult.status === Office.AsyncResultStatus.Succeeded 
                              ? console.log("主题颜色修改成功") 
                              : console.error("提交修改失败：", commitResult.error.message);
                            uploadSession.closeAsync();
                          });
                        } else {
                          console.error("设置切片失败：", setSliceResult.error.message);
                          uploadSession.closeAsync();
                        }
                      });
                    } else {
                      console.error("创建上传会话失败：", putResult.error.message);
                    }
                  });
                });
              }
            });
          });
        } else {
          console.error("获取切片失败：", sliceResult.error.message);
          file.closeAsync();
        }
      });
    } else {
      console.error("获取文档失败：", getFileResult.error.message);
    }
  });
}

注：上述代码需要引入jszip库处理ZIP压缩包，可通过CDN或本地方式集成到插件中。

二、直接操作Office Open XML的变通方案 #

本质和上述方案一致，核心是理解PowerPoint主题的XML结构：
PowerPoint的颜色主题全部定义在/ppt/theme/theme1.xml的<a:clrScheme>节点下，每个颜色对应一个子节点：

• 核心颜色：<a:dk1>、<a:lt1>、<a:dk2>、<a:lt2>
• 强调色：<a:accent1>至<a:accent6>
• 链接色：<a:hlink>、<a:folHlink>

颜色节点通常为<a:srgbClr val="RRGGBB">（自定义RGB）或<a:sysClr>（系统颜色）。修改对应节点的val属性后，将整个OOXML写回文档，即可直接更新当前主题，不会生成新调色板。

这种方式能完全控制主题细节，唯一缺点是需要处理OOXML的ZIP结构与XML解析，比原生API复杂，但能覆盖你的需求场景。

内容的提问来源于stack exchange，提问作者Felipe Costa Gualberto