通过

在 SharePoint Online 中使用单个部件应用程序页面

  • 项目

单个部件应用页提供了在 SharePoint Online 中使用锁定布局托管 SharePoint 框架 Web 部件或 Microsoft Teams 应用程序的功能。 最终用户无法修改或配置使用“单一部件应用页面”布局的页面。

应用程序页具有以下特征：

  • 最终用户无法使用浏览器编辑“单一部件应用页面”
  • 当前支持仅托管单个 Web 部件或 Microsoft Teams 应用程序
  • 最终用户可以使用新式网站提供的新>页面体验新建应用页面。
  • 开发人员只能以编程方式将页面布局从普通页面布局更改为单页应用页面
  • 单页应用页面中没有新的体验。 最终用户可以使用任何新型文章页面的功能区中提供的新/页面体验，来创建新的文章页面或单页应用页面。

当你为页面选择已使用的页面布局时，“应用页面”可作为新式页面创建功能中的一个选项。 所有已配置为也可用作应用页面的 Web 部件都可用于“创建页面”功能。

Web 部件可以配置为作为应用页面公开。 此配置通过调整 supportedHosts 值在 Web 部件清单文件中完成。 如果 supportedHosts 值包含 "SharePointFullPage" 值，Web 部件将在即将到来的应用页面选择器用户界面中作为选项公开。

以下 Web 部件清单演示了通过更新 supportedHosts 参数的所有不同值，将 Web 部件包含在所有支持的平台中的方案。

{
  // ...

  "requiresCustomScript": false,
  "supportedHosts": ["SharePointWebPart", "SharePointFullPage", "TeamsTab"],

  "preconfiguredEntries": [{
    // ...
  }]
}

如何在租户中预配单个部件应用页面？

作为开发人员，预配单一部件应用页面的两种最常见方法是使用 PnP PowerShell 或适用于 Microsoft 365 的 CLI。

可以使用 PnP PowerShell，通过以下脚本更新现有页面的页面布局。

注意

PnP PowerShell 是一种开放源代码解决方案，其中包含为其提供支持的活动社区。 没有用于 Microsoft 开放源代码工具支持的 SLA。

还可以使用适用于 Microsoft 365 的 CLI，通过以下脚本更新现有页面的页面布局。

注意

CLI for Microsoft 365是一种开放源代码解决方案，其中包含为其提供支持的活动社区。 没有用于 Microsoft 开放源代码工具支持的 SLA。

Connect-PnPOnline -Url https://contoso.sharepoint.com/sites/marketing
Set-PnPPage -Identity "Page" -LayoutType SingleWebPartAppPage

有关此 cmdlet 的完整详细信息和示例，请参阅 PnP PowerShell 文档。

你将需要基于环境调整租户和页面名称。