内容 Office 加载项
内容加载项是指可以直接嵌入 Excel 或 PowerPoint 文档的图面。 用户可以通过内容加载项访问界面控件，运行代码以修改文档或显示数据源中的数据。 在你要将功能直接嵌入文档时，请使用内容加载项。
图 1. 内容加载项的典型布局
最佳做法
- 在加载项顶部包括某些导航或命令元素，如命令栏或透视。
- 包括位于加载项底部的品牌元素，如品牌栏（仅适用于 Excel 和 PowerPoint 加载项）。
变量
Office 桌面版和 Web 浏览器中 Excel 和 PowerPoint 的内容加载项大小由用户指定。
“个性”菜单
“个性”菜单可能会妨碍靠近外接程序右上角的导航和命令元素。 以下是 Windows 和 Mac 上的“个性”菜单的当前尺寸。
对于 Windows，个性菜单尺寸为 12x32 像素，如下所示。
图 2. Windows 上的“个性”菜单
对于 Mac，“个性”菜单尺寸为 26x26 像素，但是从右侧浮动 8 个像素，再从顶部浮动 6 个像素，能将占用空间增加至 34x32 像素，如下所示。
图 3. Mac 上的“个性”菜单
实现
使用任务窗格的内容外接程序和加载项之间的清单存在细微差异。 打开正在使用的清单类型的选项卡。
注意
统一清单在 Excel、PowerPoint 和 Word 中作为开发人员预览版提供。 对于 Outlook，它已正式发布，可在生产加载项中使用。
使用以下步骤配置清单。
- 将“contentRuntimes”子数组添加到“extensions”数组中的扩展对象。
- 删除“runtimes”属性（如果存在）。 “runtimes”数组适用于任务窗格或邮件加载项。这些内容不能与内容加载项结合使用。
- 在“contentRuntimes”数组中添加匿名内容运行时对象。
- 将 对象的“id”属性设置为描述性名称。
- 将“code.page”对象设置为要在文档中嵌入的自定义内容的完整 URL。
- （可选）将“requestedWidth”和“requestedHeight”属性设置为 32 到 1000 像素之间的大小。 如果未使用这些属性，Office 应用程序将确定大小。
- （可选）将“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 执行读取和写入操作。 可以在加载项清单中声明要拥有的权限级别。