Office.js内容加载项：能否存储单个内容级的沙盒化配置设置？

好问题！针对你开发Excel内容加载项、需要给每个可视化图表单独存储专属配置（比如轴刻度、缩放级别）的场景，Office.js确实提供了沙盒化的、绑定到单个内容的存储方案，完全能实现配置和对应图表一一绑定，不会和其他图表或文档级设置混淆。下面是两种最适合的实现方式：

方案1：利用Shape自定义属性（最直接高效） #

如果你是通过Excel API插入的图表（或者把你的可视化内容封装为Shape对象），直接用Shape.customProperties就可以——这个属性是完全绑定到具体Shape实例的，每个Shape的自定义属性都是独立的沙盒，完美匹配你的需求。

示例代码 #

保存图表配置

// 假设你已经获取到目标图表对应的Shape对象
async function saveChartSettings(shape, userSettings) {
  await Excel.run(async (context) => {
    const customProps = shape.customProperties;
    // 逐个存入用户配置项
    customProps.add("axisScale", userSettings.axisScale);
    customProps.add("zoomLevel", userSettings.zoomLevel);
    await context.sync();
  });
}

读取图表配置

async function loadChartSettings(shape) {
  const userSettings = {};
  await Excel.run(async (context) => {
    const customProps = shape.customProperties.load("key, value");
    await context.sync();
    
    // 遍历属性组装配置对象
    customProps.items.forEach(prop => {
      userSettings[prop.key] = prop.value;
    });
  });
  return userSettings;
}

这个方案的优势就是简单直接，配置和图表强绑定，完全不用担心和其他内容的配置混淆。

方案2：自定义XML部件（适合复杂结构化数据） #

如果你的可视化配置比较复杂（比如需要存储多层嵌套的结构化数据），可以用CustomXmlParts。核心思路是给每个图表生成一个唯一标识符（比如UUID），然后创建一个和该ID关联的XML部件，把配置以XML或JSON格式存储进去，同样能实现沙盒化隔离。

示例代码 #

保存结构化配置

async function saveChartConfig(chartUniqueId, userSettings) {
  await Excel.run(async (context) => {
    // 把配置转为XML格式（也可以存JSON字符串）
    const xmlContent = `<ChartConfig>
      <AxisScale>${userSettings.axisScale}</AxisScale>
      <ZoomLevel>${userSettings.zoomLevel}</ZoomLevel>
    </ChartConfig>`;
    // 通过命名空间关联唯一ID，确保配置和图表一一对应
    context.workbook.customXmlParts.add(xmlContent, `urn:chart-config:${chartUniqueId}`);
    await context.sync();
  });
}

读取配置

async function loadChartConfig(chartUniqueId) {
  const userSettings = {};
  await Excel.run(async (context) => {
    const xmlParts = context.workbook.customXmlParts.getByNamespace(`urn:chart-config:${chartUniqueId}`);
    xmlParts.load("items");
    await context.sync();
    
    if (xmlParts.items.length > 0) {
      const xmlText = xmlParts.items[0].getXml();
      await context.sync();
      // 解析XML内容到配置对象（可以用DOMParser或第三方库简化）
      const parser = new DOMParser();
      const xmlDoc = parser.parseFromString(xmlText.value, "application/xml");
      userSettings.axisScale = xmlDoc.querySelector("AxisScale").textContent;
      userSettings.zoomLevel = xmlDoc.querySelector("ZoomLevel").textContent;
    }
  });
  return userSettings;
}

这个方案适合存储复杂数据，灵活性更高，同样能保证每个图表的配置独立隔离。

关键注意点 #

• 不管用哪种方案，都要确保你能唯一标识每个图表：可以直接用Shape的ID，或者自己生成UUID并关联到图表（比如存在Shape的自定义属性里），这样才能准确找到对应配置。
• 这两种方案的数据都是存储在Excel文档内部的，会和文档一起保存，不会丢失。

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