Пользовательские элементы управления и веб-элементы управления в модели надстройки SharePoint
Подход, который вы используете для реализации пользовательских элементов управления в коде, в новой модели надстройки SharePoint отличается от подхода к коду полного доверия. В типичном сценарии с кодом полного доверия (FTC) или решением фермы пользовательские элементы управления создавались как пользовательские или веб-элементы управления и развертывались с помощью решений SharePoint.
В сценарии модели надстройки SharePoint JavaScript внедряется на страницы SharePoint для реализации пользовательских элементов управления.
Рекомендации высокого уровня
Как правило, мы хотели бы предоставить следующие общие рекомендации по созданию пользовательских элементов управления в новой модели надстройки SharePoint.
- Используйте внедренный Код JavaScript для создания пользовательских элементов управления.
- Используйте клиентская объектная модель SHAREPoint ECMA (CSOM) и (или) ИНТЕРФЕЙСы REST API SharePoint/Office 365 для взаимодействия с данными и службами SharePoint.
Параметры внедрения JavaScript на страницы SharePoint
У вас есть несколько вариантов внедрения JavaScript на страницах SharePoint.
- Использование пользовательских действий
- Внедрение JavaScript непосредственно в макеты страниц
- Внедрение JavaScript непосредственно в пользовательские страницы master (не рекомендуется)
Использование пользовательских действий
В этом шаблоне пользовательские действия используются для внедрения JavaScript в страницу во время выполнения.
- Этот подход абсолютно поддерживается и является допустимым.
Для каких случаев он подходит?
Если вам нужно внедрить JavaScript на все страницы SharePoint, этот вариант подходит.
Начало работы
В следующей статье и сопровождающем видео показано, как использовать пользовательские действия для внедрения JavaScript на страницы SharePoint.
- Core.EmbedJavaScript (пример PnP O365)
- OD4B. NavLinksInjection (пример PnP O365)
- Навигация по семействам веб-сайтов (видео o365 PnP)
Внедрение JavaScript непосредственно в макеты страниц
В этом шаблоне JavaScript внедряется непосредственно в макеты страниц на сайтах публикации.
- Этот подход абсолютно поддерживается и является допустимым.
- Этот подход работает с сайтами публикации.
Для каких случаев он подходит?
Если необходимо внедрить JavaScript в определенные макеты страниц SharePoint на сайтах публикации в сценарии WCM, этот вариант подходит.
Внедрение JavaScript непосредственно в пользовательские страницы master
В этом шаблоне JavaScript внедряется непосредственно в пользовательские страницы master.
- Этот подход не рекомендуется.
- Этот подход является допустимым.
- Вы можете внедрить JavaScript непосредственно в пользовательские master страницы, но имейте в виду, что это приведет к дополнительным долгосрочным затратам и проблемам при будущих обновлениях.
- Если вы решили использовать пользовательские эталонные страницы, будьте готовы вносить в них изменения при применении значительных функциональных обновлений в Office 365.
Для каких случаев он подходит?
Если необходимо внедрить JavaScript для каждой master страницы, это хороший вариант, так как он позволяет управлять master страницами, в которые внедрен JavaScript.
См. также
- Навигация по семействам веб-сайтов (видео o365 PnP)
- Статьи руководства на https://aka.ms/OfficeDevPnPGuidance
- Ссылки в MSDN на https://aka.ms/OfficeDevPnPMSDN
- Видео на https://aka.ms/OfficeDevPnPVideos
Образцы PnP
- Core.EmbedJavaScript (пример PnP O365)
- OD4B. NavLinksInjection (пример PnP O365)
- Core.EmbedJavaScript.WeekNumbers (пример PnP O365)
- Core.EmbedJavaScriptJSOM (пример PnP O365)
- Core.JavaScriptНастройка (сценарий PnP O365 с использованием компонента PnP Core)
- Примеры и содержимое в Microsoft 365 Patterns and Practices (PnP)
Область применения
- Office 365 Multi Tenant (MT)
- Office 365 Dedicated (D)
- Локальное развертывание SharePoint 2013