如何配置Excel非函数任务窗格加载项：自动显示与自动加载按需显示

• 配置加载项清单文件：在OfficeApp节点下针对桌面版和网页版分别添加DesktopFormFactor和WebFormFactor配置，通过AutoShowTaskpane扩展点实现自动弹窗。
  • 核心配置片段：

    <DesktopFormFactor>
      <FunctionFile resid="Commands.Url" />
      <ExtensionPoint xsi:type="AutoShowTaskpane">
        <TaskpaneId>YourTaskPaneID</TaskpaneId>
        <Visibility>
          <Rule xsi:type="Workbook" />
        </Visibility>
      </ExtensionPoint>
    </DesktopFormFactor>
    

• 额外说明：网页版需确保加载项已被用户固定到目标工作簿；桌面版需加载项已完成安装并与工作簿关联。

实现思路 #

让加载项后台静默启动，通过代码检测工作簿是否存在加载项使用痕迹，再决定是否显示任务窗格，同时提供关闭自动触发的选项。

步骤1：配置清单实现静默加载 #

• 移除清单中AutoShowTaskpane相关配置，避免打开时自动弹窗。
• 将加载项权限设置为ReadWriteDocument，确保有足够权限读取工作簿数据。

步骤2：编写启动检测逻辑 #

在加载项初始化代码中加入检测与触发逻辑：

Office.onReady(async () => {
  await Excel.run(async (context) => {
    // 读取工作簿自定义属性，检查是否有使用痕迹
    const customProps = context.workbook.properties.custom;
    customProps.load("items");
    await context.sync();

    // 检查是否存在使用标记，同时排除禁用状态
    const hasUsedBefore = customProps.items.some(item => item.key === "AddInUsed");
    const isDisabled = customProps.items.some(item => item.key === "AutoOpenDisabled");
    
    if (hasUsedBefore && !isDisabled) {
      // 显示任务窗格
      await Office.addin.showTaskpane();
      // 绑定关闭自动触发的按钮事件
      document.getElementById("turnOffAutoOpen").addEventListener("click", disableAutoOpen);
    }
  });
});

// 关闭自动触发的函数
async function disableAutoOpen() {
  await Excel.run(async (context) => {
    const customProps = context.workbook.properties.custom;
    customProps.add("AutoOpenDisabled", "true");
    await context.sync();
    alert("已关闭自动打开功能");
  });
}

步骤3：跨版本兼容处理 #

• 桌面版：确保加载项已安装，且用户已将其固定到目标工作簿。
• 网页版：加载项需被用户固定到工作簿，否则打开时不会自动加载。

关键提示 #

• 用工作簿自定义属性存储使用痕迹和禁用状态，既不影响用户操作，又能稳定读取。
• 静默加载状态下，加载项代码在后台运行，无UI显示，直到调用showTaskpane才会弹出任务窗格。

内容的提问来源于stack exchange，提问作者T.J. Crowder