Контентные надстройки Office

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

Рис. 1. Типичный макет для контентных надстроек

Типичный макет для контентных надстроек в приложении Office.

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

  • Добавьте элемент навигации или управления, такой как CommandBar или Pivot, в верхнюю часть надстройки.
  • Добавьте элемент фирменной символики, такой как BrandBar, в нижнюю часть надстройки (применимо только к надстройкам Excel и PowerPoint).

Варианты

Размеры контентных надстроек для Excel и PowerPoint в классической версии Office и в веб-браузере указаны пользователем.

Меню личных данных

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

Меню личных данных в Windows имеет размер 12 x 32 пикселей, как показано ниже.

Рис. 2. Меню "Личность" в Windows

12x32-пиксельное меню личных данных на рабочем столе Windows.

В Mac меню личных данных имеет размер 26 x 26 точек, но сдвинуто на 8 пикселей влево и на 6 вниз, из-за чего оно занимает пространство размером 34 x 32 пикселей, как показано на изображении.

Рис. 3. Меню "Личность" на Компьютере Mac

34x32-пиксельное меню личных данных на рабочем столе Mac.

Реализация

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

Настройте манифест, выполнив следующие действия.

  1. Добавьте дочерний "contentRuntimes" массив к объекту расширения в массиве "extensions" .
  2. Удалите свойство, "runtimes" если оно присутствует. Массив "runtimes" предназначен для надстроек области задач или почтовых надстроек. Их нельзя комбинировать с контентной надстройкой.
  3. Добавьте в массив объект среды выполнения анонимного содержимого "contentRuntimes" .
  4. Присвойте "id" свойству объекта описательное имя.
  5. Задайте для "code.page" объекта полный URL-адрес пользовательского содержимого, которое требуется внедрить в документ.
  6. При необходимости задайте "requestedWidth" для свойств и "requestedHeight" размер от 32 до 1000 пикселей. Если эти свойства не используются, приложение Office определяет размер.
  7. При необходимости присвойте свойству "disableSnapshot" значение , true чтобы запретить Office сохранять snapshot компонента содержимого с документом.

Ниже приведен пример "contentRuntimes" свойства .

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

Примеры на портале GitHub

В репозитории Office-Add-in-samples на GitHub доступны примеры кода контентных надстроек. Вы можете использовать любой из них в качестве основы для собственного проекта надстройки. Некоторые из них также дают возможность попробовать надстройку, не запуская ее локально.

Что касается поддержки

  • Проверьте, будет ли надстройка Office работать с определенным приложением Или платформой Office.
  • Чтобы надстройка могла читать и записывать данные в Excel или PowerPoint, может потребоваться добавление в список доверенных. Вы можете объявить нужный уровень разрешений для пользователя в манифесте надстройки.
  • В Office в Интернете параметр Показать как сохраненный образ не поддерживается. Даже если параметр Показать сохраненное изображение был включен в классическом клиенте, контентная надстройка остается интерактивной в веб-клиенте.

См. также

  • Last updated on