功能区 API 要求集

要求集是指各组已命名的 API 成员。 Office 加载项使用清单中指定的要求集或执行运行时检查，以确定 Office 应用程序是否支持加载项所需的 API。有关详细信息，请参阅 Office 版本和要求集。

功能区 API 集支持以编程方式控制自定义外接程序命令 (（即启用和禁用自定义功能区按钮和菜单项) 以及上下文选项卡出现在功能区上的时间）。

Office 外接程序在多个 Office 版本中运行。下表列出了功能区 API 要求集、支持的 Office 客户端应用程序，以及这些应用程序（如果适用） 的最低 版本。

要求集	Windows 版 Office (Microsoft 365 订阅)	Windows 版 Office (零售永久 Office 2016 或更高版本)	Windows 版 Office (批量许可的永久)	Mac 版 Office	iPad 版 Office	Office 网页版	Office Online Server
RibbonApi 1.2	版本 2102（内部版本 13801.20294）	版本 2102（内部版本 13801.20294）	Office 2021：版本 2108 (内部版本 14326.20454)	16.53.806.0	不支持	支持	不支持
RibbonApi 1.1	请参阅支持 section	版本 2006（内部版本 13001.20266）	Office 2021：版本 2108 (内部版本 14326.20454)	16.38	不支持	支持	不支持

重要

仅任务窗格加载项支持 RibbonApi 要求集。
RibbonApi 要求集仅在 Excel 中支持生产加载项。
RibbonApi 1.1 (1.2) 在 PowerPoint 和 Word 中以预览版的形式提供，但仅在 Windows 上的 Office (Microsoft 365 订阅) 和 Mac 版 Office 中提供。它还在 PowerPoint web 版中提供预览版。若要了解如何访问 Office.js 预览 API，请参阅访问 Office JavaScript API 库。

支持 Windows 上的 Office 版本 1.1 (Microsoft 365 订阅)

从版本 2006 (内部版本 13001.20498) ，消费者通道支持 1.1 版本的 RibbonApi 要求集。自 2020 年 7 月 14 日起提供的 Semi-Annual 频道和每月企业频道版本中也支持该要求集。每个通道支持 的最低 版本如下：

若要了解通用 API 要求集，请参阅 Office 通用 API 要求集。

功能区 API 1.1 是 API 的第一个版本。有关 API 的详细信息，请参阅 Office.功能区参考主题。

此要求集包括对启用和禁用外接程序命令的支持。有关详细信息，请参阅启用和禁用加载项命令。

功能区 API 1.2 添加了对上下文选项卡的支持。更多信息，请参见在Office插件中创建自定义上下文选项卡。

注意

清单中尚不支持 RibbonApi 1.2 要求集，因此不应在清单的 <“要求> ”部分中指定它。