仅含XML命令的Microsoft Word加载项开发可行性咨询

可行性确认 #

完全可行。这类加载项属于无UI命令型加载项，不需要配置任务窗格，所有交互仅通过清单定义的功能区按钮/上下文菜单触发后台脚本执行，完全符合需求。

核心实现要点 #

• 清单配置：重点在<VersionOverrides>节点下定义命令，无需设置<DefaultSettings>中的任务窗格URL，只需指定命令触发的函数文件地址、按钮位置、图标和文本资源。
• 后台脚本：编写对应JavaScript函数，通过Office.js API完成Word文档操作，脚本需托管在公网可访问的地址，清单中通过<FunctionFile>关联。

简化实现示例 #

清单核心片段

<VersionOverrides xmlns="http://schemas.microsoft.com/office/taskpaneappversionoverrides" xsi:type="VersionOverridesV1_0">
  <Hosts>
    <Host xsi:type="Document">
      <DesktopFormFactor>
        <!-- 指定命令脚本文件地址 -->
        <FunctionFile resid="Commands.Url"/>
        <!-- 在功能区添加自定义选项卡和按钮 -->
        <ExtensionPoint xsi:type="PrimaryCommandSurface">
          <CustomTab id="CustomTab">
            <Group id="CustomGroup">
              <Label resid="Group.Label"/>
              <Control xsi:type="Button" id="InsertTextButton">
                <Label resid="Button.Label"/>
                <Supertip>
                  <Title resid="Button.Title"/>
                  <Description resid="Button.Description"/>
                </Supertip>
                <Icon>
                  <bt:Image size="16" resid="Icon.16"/>
                  <bt:Image size="32" resid="Icon.32"/>
                  <bt:Image size="80" resid="Icon.80"/>
                </Icon>
                <!-- 绑定触发的函数 -->
                <Action xsi:type="ExecuteFunction">
                  <FunctionName>insertSampleText</FunctionName>
                </Action>
              </Control>
            </Group>
            <Label resid="Tab.Label"/>
          </CustomTab>
        </ExtensionPoint>
      </DesktopFormFactor>
    </Host>
  </Hosts>
  <!-- 资源定义：图标、URL、文本 -->
  <Resources>
    <bt:Images>
      <bt:Image id="Icon.16" DefaultValue="https://your-server.com/icon-16.png"/>
      <bt:Image id="Icon.32" DefaultValue="https://your-server.com/icon-32.png"/>
      <bt:Image id="Icon.80" DefaultValue="https://your-server.com/icon-80.png"/>
    </bt:Images>
    <bt:Urls>
      <bt:Url id="Commands.Url" DefaultValue="https://your-server.com/commands.js"/>
    </bt:Urls>
    <bt:ShortStrings>
      <bt:String id="Group.Label" DefaultValue="自定义工具"/>
      <bt:String id="Button.Label" DefaultValue="插入示例文本"/>
      <bt:String id="Button.Title" DefaultValue="插入示例文本"/>
      <bt:String id="Tab.Label" DefaultValue="我的加载项"/>
    </bt:ShortStrings>
    <bt:LongStrings>
      <bt:String id="Button.Description" DefaultValue="在文档中插入预设的示例文本"/>
    </bt:LongStrings>
  </Resources>
</VersionOverrides>

对应命令脚本（commands.js）

// 初始化Office.js
Office.onReady(() => {});

// 自定义命令函数
function insertSampleText(event) {
  Word.run(async (context) => {
    // 向文档末尾插入文本
    const body = context.document.body;
    body.insertParagraph("这是通过命令触发插入的文本", Word.InsertLocation.end);
    await context.sync();
    // 通知Office命令执行完成
    event.completed();
  }).catch((error) => {
    console.error(error);
    event.completed();
  });
}

// 将函数关联到Office加载项
Office.actions.associate("insertSampleText", insertSampleText);

替代实现方式 #

• 上下文菜单扩展：如果需要右键触发命令，可将清单中的<ExtensionPoint>类型改为ContextMenu，绑定到文档、选中内容等上下文场景。
• 简化脚本逻辑：对于简单操作，可直接复用Office.js内置能力，但多数场景仍需自定义脚本处理业务逻辑。

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