Наборы обязательных элементов API ленты

  • Статья

Наборы требований — это именованные группы элементов API. Надстройки Office с помощью наборов обязательных элементов, указанных в манифесте, или проверки в среде выполнения определяют, поддерживает ли клиентское приложение Office необходимые API. Дополнительные сведения см. в разделе Версии Office и наборы требований.

Набор API ленты поддерживает программное управление включением и отключением пользовательских команд надстройки (то есть настраиваемых кнопок ленты и пунктов меню), а также при отображении контекстных вкладок на ленте.

Надстройки Office работают в нескольких версиях Office. В следующей таблице перечислены наборы обязательных элементов API ленты, поддерживаемые клиентские приложения Office, а также минимальные сборки или версии для этих приложений, где это применимо.

Набор обязательных элементов Office для Windows
(подписка На Microsoft 365)		 Office для Windows
(розничная версия Office 2016 с бессрочным сроком 2016 или более поздней версии)		 Office для Windows
(корпоративный бессрочный)		 Office для Mac Office для iPad 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, но только в Office для Windows (подписка На Microsoft 365) и Office на Mac. Он также доступен для предварительной версии в PowerPoint в Интернете. Сведения о том, как получить доступ к API Office.js предварительной версии, см. в статье Доступ к библиотеке API JavaScript для Office.

Поддержка версии 1.1 в Office в Windows (подписка На Microsoft 365)

Версия 1.1 набора требований RibbonApi поддерживается в канале consumer с версии 2006 (сборка 13001.20498). Этот набор требований также поддерживается в сборках Semi-Annual Channel и Monthly Enterprise Channel, доступных с 14 июля 2020 г. Ниже приведены минимальные поддерживаемые сборки для каждого канала.

Канал Минимальная версия Минимальная сборка
Актуальный канал 2006 13001.20266
Ежемесячный канал (корпоративный) 2005 12827.20538
Ежемесячный канал (корпоративный) 2004 12730.20602
Полугодовой канал (корпоративный) 2002 12527.20880

Дополнительная информация

Статьи и разделы с дополнительными сведениями о версиях, номерах сборок и Office Online Server:

Наборы обязательных элементов общего API для Office

Сведения о наборах обязательных элементов общего API см. в статье Наборы обязательных элементов общего API для Office.

API ленты 1.1

API ленты 1.1 — это первая версия API. Дополнительные сведения об API см. в справочном разделе Office.ribbon .

Этот набор требований включает в себя поддержку включения и отключения команд надстроек. Дополнительные сведения см. в статье о Включение и отключение команд надстроек.

API ленты 1.2

API ленты 1.2 добавляет поддержку контекстных вкладок. Дополнительные сведения см. в статье Создание пользовательских контекстных вкладок в надстройках Office.

Примечание.

Набор обязательных элементов RibbonApi 1.2 пока не поддерживается в манифесте, поэтому не следует указывать его в разделе Требования> манифеста<.

См. также