通过

内容 Office 加载项

内容加载项是指可以直接嵌入 Excel 或 PowerPoint 文档的图面。 用户可以通过内容加载项访问界面控件，运行代码以修改文档或显示数据源中的数据。 在你要将功能直接嵌入文档时，请使用内容加载项。

图 1. 内容加载项的典型布局

Office 应用程序中内容加载项的典型布局。

最佳做法

  • 在加载项顶部包括某些导航或命令元素，如命令栏或透视。
  • 包括位于加载项底部的品牌元素，如品牌栏（仅适用于 Excel 和 PowerPoint 加载项）。

变量

Office 桌面版和 Web 浏览器中 Excel 和 PowerPoint 的内容加载项大小由用户指定。

“个性”菜单

“个性”菜单可能会妨碍靠近外接程序右上角的导航和命令元素。 以下是 Windows 和 Mac 上的“个性”菜单的当前尺寸。

对于 Windows，个性菜单尺寸为 12x32 像素，如下所示。

图 2. Windows 上的“个性”菜单

Windows 桌面上的 12x32 像素个性菜单。

对于 Mac，“个性”菜单尺寸为 26x26 像素，但是从右侧浮动 8 个像素，再从顶部浮动 6 个像素，能将占用空间增加至 34x32 像素，如下所示。

图 3. Mac 上的“个性”菜单

Mac 桌面上的 34x32 像素个性菜单。

实现

使用任务窗格的内容外接程序和加载项之间的清单存在细微差异。 打开正在使用的清单类型的选项卡。

注意

统一清单在 Excel、PowerPoint 和 Word 中作为开发人员预览版提供。 对于 Outlook，它已正式发布，可在生产加载项中使用。

使用以下步骤配置清单。

  1. 将 "contentRuntimes" 子数组添加到数组中的 "extensions" 扩展对象。
  2. 如果属性存在， "runtimes" 则将其删除。 数组 "runtimes" 适用于任务窗格或邮件加载项。这些内容不能与内容加载项结合使用。
  3. 在数组中添加匿名内容运行时对象 "contentRuntimes" 。
  4. 将 "id" 对象的 属性设置为描述性名称。
  5. 将 "code.page" 对象设置为要在文档中嵌入的自定义内容的完整 URL。
  6. （可选）将 "requestedWidth" 和 "requestedHeight" 属性设置为 32 到 1000 像素之间的大小。 如果未使用这些属性，Office 应用程序将确定大小。
  7. （可选）将 "disableSnapshot" 属性设置为 true ，以防止 Office 将内容组件快照与文档一起保存。

下面是 属性的示例 "contentRuntimes" 。

"contentRuntimes": [
    {
        "id": "ContentRuntime",
        "code": {
            "page": "https://localhost:3000/content.html"
        },
        "requestedWidth": 100,
        "requestedHeight": 100,
        "disableSnapshot": true,
    }
]

有关实现内容加载项的示例，请参阅 GitHub 上的 Excel 内容外接程序 Humongous Insurance 。

若要创建自己的内容外接程序，请参阅 Excel 内容外接程序快速入门 和 PowerPoint 内容外接程序快速入门。

支持注意事项

  • 检查 Office 加载项是否适用于 特定的 Office 应用程序或平台。
  • 一些内容加载项可能会要求用户“信任”加载项对 Excel 或 PowerPoint 执行读取和写入操作。 可以在加载项清单中声明要拥有的权限级别。

另请参阅