Команды надстроек для Excel, PowerPoint и Word

Команды надстроек — это элементы, которые расширяют пользовательский интерфейс Office и запускают действия в надстройке. Команды надстроек можно использовать для добавления кнопки на ленту или элемента в контекстное меню. Когда пользователи выбирают команду надстройки, они инициируют действия, такие как запуск кода JavaScript или отображение страницы надстройки в области задач. Команды надстройки помогают пользователям находить и использовать вашу надстройку, что может повысить показатель внедрения надстройки и коэффициент удержания клиентов.

Обзор этой функции приведен в видео, посвященном командам надстроек на ленте приложения Office.

Примечание

В каталогах SharePoint команды надстроек не поддерживаются. Развернуть их можно с помощью интегрированных приложений или AppSource. Чтобы развернуть команду надстройки для тестирования, используйте загрузку неопубликованного приложения.

Важно!

В Outlook также поддерживаются команды надстроек. Дополнительные сведения см. в статье Команды надстроек для Outlook.

Рисунок 1. Надстройка с командами, работающая в классическом приложении Excel

Снимок экрана, на котором выделены команды надстройки на ленте Excel.

Рисунок 2. Надстройка с командами, работающая в Excel в Интернете

Снимок экрана с командами надстроек в Excel в Интернете.

Возможности команд

В настоящее время поддерживаются указанные ниже возможности команд.

Примечание

Контентные надстройки на данный момент не поддерживают команды.

Точки расширения

  • Вкладки ленты: расширение возможностей встроенных вкладок или создание пользовательской вкладки.
  • Контекстные меню: расширение возможностей выбранных контекстных меню.

Типы элементов управления

  • Простые кнопки, запускающие определенные действия.
  • Простые раскрывающиеся меню с кнопками, которые запускают действия.

Действия

  • ShowTaskpane: отображает одну или несколько областей, в которые можно загрузить пользовательские HTML-страницы.
  • ExecuteFunction загружает невидимую HTML-страницу, а затем выполняет содержащуюся в ней функцию JavaScript. Для показа ошибок, хода выполнения или дополнительных данных функции можно использовать API displayDialog.

Состояние по умолчанию: "Включено" или "Отключено"

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

Примечание

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

Расположение на ленте (предварительная версия)

Вы можете указать, где настраиваемая вкладка будет отображаться на ленте приложения Office, например "справа от вкладки «Главная»".

Примечание

Эта функция поддерживается не всеми приложениями Office и сценариями. Дополнительные сведения см. в статье Расположение настраиваемой вкладки на ленте.

Интеграция встроенных кнопок Office (предварительная версия)

Вы можете вставлять встроенные кнопки ленты Office в свои группы настраиваемых команд и настраиваемые вкладки ленты.

Примечание

Эта функция поддерживается не всеми приложениями Office и сценариями. Дополнительные сведения см. в статье Интеграция встроенных кнопок Office в настраиваемые вкладки.

Контекстные вкладки (предварительная версия)

Вы можете настроить отображение вкладки на ленте только в определенных контекстах, например при выборе диаграммы в Excel.

Примечание

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

Поддерживаемые платформы

В настоящее время команды надстроек поддерживаются на следующих платформах (за исключением ограничений, указанных в подразделах Возможности команд ранее).

  • Office для Windows (сборка 16.0.6769+, подключенная к подписке на Microsoft 365)
  • Office 2019 или более поздней версии для Windows
  • Office для Mac (сборка 15.33+, подключенная к подписке на Microsoft 365)
  • Office 2019 или более поздней версии для Mac
  • Office в Интернете

Примечание

Сведения о поддержке Outlook см. вКоманды надстройки для Outlook.

Отладка

Чтобы отлаживать команду надстройки, необходимо запустить ее в Office в Интернете. Дополнительные сведения см. в статье Отладка надстроек в Office в Интернете

Рекомендации

При разработке надстроек придерживайтесь следующих рекомендаций.

  • Каждая команда должна представлять определенное действие с очевидным и конкретным исходом для пользователей. Не совмещайте несколько действий в одной кнопке.

  • Предоставляйте точные действия, которые делают выполнение распространенных задач в надстройке более эффективным. Максимально сократите количество шагов, необходимых для выполнения действия.

  • Расположение команд на ленте приложения Office:

    • Помещайте команды на имеющиеся вкладки ("Вставка", "Рецензирование" и т. д.), если соответствующая функция подходит для них. Например, если надстройка позволяет вставлять файлы мультимедиа, добавьте группу на вкладку "Вставка". Обратите внимание, что некоторые вкладки доступны не во всех версиях Office. Дополнительные сведения см. в статье XML-манифест надстроек Office.
    • Добавляйте команды на вкладку "Главная", если соответствующие функции не относятся к другим вкладкам, а надстройка содержит менее шести команд верхнего уровня. Вы также можете добавлять команды на вкладку "Главная", если надстройка должна работать в разных версиях Office (например, Office в Интернете и классических приложениях Office), а нужная вкладка доступна не во всех версиях (например, вкладка "Конструктор" отсутствует в Office в Интернете).
    • Добавляйте команды на пользовательскую вкладку, если надстройка содержит более шести команд верхнего уровня.
    • Название группы должно соответствовать названию надстройки. Если у вас есть несколько групп, их имена должны быть связаны с функциями, которые выполняют команды из этих групп.
    • Не добавляйте избыточные кнопки, чтобы надстройка занимала больше места на экране.
    • Не размещайте настраиваемую вкладку слева от вкладки "Главная" или переводите на нее фокус по умолчанию при открытии документа, если ваша надстройка не является основным способом взаимодействия с документом. Чрезмерное выделение вашей надстройки создает неудобства и раздражает пользователей и администраторов.
    • Если надстройка является основным способом взаимодействия пользователей с документом и у вас есть настраиваемая вкладка ленты, рассмотрите возможность интеграции кнопок во вкладку для применения функций Office, которые часто требуются пользователям.
    • Если функции, предоставляемые в настраиваемой вкладке, должны быть доступны только в определенных контекстах, используйте настраиваемые контекстные вкладки. Если вы используете настраиваемые контекстные вкладки, реализуйте резервный интерфейс, когда ваша надстройка запускается на платформах, не поддерживающих настраиваемые контекстные вкладки.

    Примечание

    Надстройки, которые занимают слишком много места, могут не пройти проверку в AppSource.

  • Руководство по оформлению значков подходит для всех значков.

  • Предоставьте версию надстройки, которая работает в приложениях Office, не поддерживающих команды. Один манифест надстройки может работать в приложениях независимо от того, поддерживают ли они команды.

    Рис. 3. Надстройка области задач в Office 2013 и эта же надстройка, использующая команды надстройки в Office 2016

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

Дальнейшие действия

Лучший способ начать работу с командами надстроек Office — ознакомиться с примерами на сайте GitHub.

Дополнительные сведения об указании команд надстройки в манифесте см. в статье Создание команд надстроек в манифесте и справочных материалах по VersionOverrides.