SharePoint 加载项模型中的用户控件和 Web 控件
在新 SharePoint 外接程序模型中实施代码中的自定义控件的方法与使用完全信任代码不同。 在典型完全信任代码 (FTC)/场解决方案场景中,自定义控件构建为用户控件或 Web 控件并通过 SharePoint 解决方案部署。
在 SharePoint 外接程序模型场景中,JavaScript 被嵌入 SharePoint 页面以实施自定义控件。
高级别准则
作为经验法则,我们希望提供以下高级别准则,以在新的 SharePoint 外接程序模型中创建自定义控件。
- 使用嵌入的 JavaScript 来创建自定义控件。
- 使用 SharePoint ECMA 客户端对象模型 (CSOM) 和/或 SharePoint/Office 365 REST API 与 SharePoint 数据和服务进行交互。
在 SharePoint 页面中嵌入 JavaScript 的选项
有几个选项可以在 SharePoint 页面中嵌入 JavaScript。
- 使用自定义用户操作
- 直接将 JavaScript 嵌入页面布局
- 直接将 JavaScript 嵌入自定义母版页(不推荐)
使用自定义用户操作
在此模式中,自定义用户操作用于在运行时将 JavaScript 嵌入页面。
- 绝对支持这种方法,它是一种有效的方法。
何时适合?
当需要将 SharePoint 嵌入所有 JavaScript 页面时,此选项非常适合。
入门
以下文章和随附的视频演示了如何使用自定义用户操作将 JavaScript 嵌入 SharePoint 页面。
- Core.EmbedJavaScript(O365 PnP 示例)
- OD4B.NavLinksInjection(O365 PnP 示例)
- Cross site collection navigation(跨网站集导航)(O365 PnP 视频)
直接将 JavaScript 嵌入页面布局
在此模式中,JavaScript 直接嵌入发布网站中的页面布局。
- 绝对支持这种方法,它是一种有效的方法。
- 这种方法适用于发布网站。
何时适合?
当在 WCM 场景中需要将 JavaScript 嵌入发布网站中的特定 SharePoint 页面布局时,此选项非常适合。
直接将 JavaScript 嵌入自定义母版页
在此模式中,JavaScript 直接嵌入自定义母版页。
- 不推荐采用此方法。
- 这种方法是一种有效的方法。
- JavaScript 可以直接嵌入自定义母版页,但请记住这将导致与未来更新相关的额外长期成本和挑战。
- 如果选择使用自定义母版页,则需要做好准备,以在 Office 365 应用主要功能更新后将相应的更改应用到自定义母版页中。
何时适合?
当你需要以每个母版页为基础嵌入 JavaScript 时,这是一个好的选择,因为它允许你控制将 JavaScript 嵌入哪些母版页。
相关链接
- Cross site collection navigation(跨网站集导航)(O365 PnP 视频)
- 指南文章中 https://aka.ms/OfficeDevPnPGuidance
- MSDN 中的引用位于 https://aka.ms/OfficeDevPnPMSDN
- 视频中的 https://aka.ms/OfficeDevPnPVideos
PnP 示例
- Core.EmbedJavaScript(O365 PnP 示例)
- OD4B.NavLinksInjection(O365 PnP 示例)
- Core.EmbedJavaScript.WeekNumbers(O365 PnP 示例)
- Core.EmbedJavaScriptJSOM(O365 PnP 示例)
- Core.JavaScriptCustomization(使用 PnP 核心组件的 O365 PnP 场景)
- Microsoft 365 模式和实践中的示例和内容 (PnP)
适用于
- Office 365 多租户 (MT)
- Office 365 专用 (D)
- SharePoint 2013 本地