Microsoft Teams 选项卡

选项卡是嵌入在 Microsoft Teams、Outlook 和 Microsoft 365 中的客户端感知网页。 它们是简单的 HTML 标记，指向在应用清单中声明的域，并且可以添加为团队内部频道、群组聊天或个人用户的个人应用的一部分。 可在应用中包含自定义选项卡，以便在 Teams 中嵌入自己的 Web 内容，或将 Teams 特定的功能添加到 Web 内容。 有关详细信息，请参阅 Teams JavaScript 客户端库。

重要

自定义选项卡在政府社区云中可用， (GCC) 、GCC-High 和国防部 (DOD) 。

下图显示了静态选项卡：

下图显示了 Contoso 频道选项卡：

在使用选项卡之前，必须先完成几个先决条件。

Teams 中提供两种类型的选项卡：个人选项卡和组。 个人选项卡 也称为静态选项卡。 个人 (静态) 选项卡以及个人范围的机器人是个人应用的一部分，这些应用的范围限定为单个用户，并固定到左侧导航栏以便于访问。 个人 (个人范围内的静态) 选项卡继续以相同的方式工作。 但是，你现在可以将静态选项卡扩展到具有可自定义体验的群组聊天或会议。

可以将静态选项卡扩展到不同的范围。 聊天、频道或会议中的静态选项卡的行为更类似于应用，因为每个应用只能固定一个选项卡。 例如，只能在会议中固定一个 YouTube 应用选项卡。 IT 管理员还可以在会议中预先固定会议中的静态选项卡。

下图显示了静态选项卡，其中包含添加到 Teams 中不同上下文的可自定义体验：

下图显示了 Teams 桌面客户端中个人上下文中的静态选项卡：

下图显示了 Teams 移动客户端中个人上下文中的静态选项卡：

下图显示了 Teams 桌面客户端中的会议上下文中的静态选项卡：

下图显示了 Teams 移动客户端中的会议上下文中的静态选项卡：

以下是聊天和会议选项卡中静态选项卡的一些优势：

可固定和即时：可以通过在聊天和会议中添加选项卡图标固定具有静态选项卡 + 的应用。 这些选项卡可以取消固定，并且没有强制配置对话框，这允许你创建功能更类似于应用的选项卡。

统一：可以创建一个在个人和组范围内工作的静态选项卡，例如聊天和会议选项卡。

可选配置：可以通过在 Teams 中固定应用后更改应用的属性来更改 contentUrl 选项卡实例中的默认 URL。

频道或组选项卡 也称为可配置选项卡，将内容传送到频道和群组聊天，是围绕基于 Web 的专用内容创建协作空间的一种方法。

下表可帮助你确定最适合你的应用：

注意

如果你在应用清单中为特定范围定义了 可配置的选项卡 和 静态选项卡 ，则默认情况下，Teams 会固定静态选项卡。

可以在 TeamsJS v1.x) 中创建 内容页 作为个人静态选项卡、频道或组选项卡或对话 (称为任务模块的一部分。 可以创建一个配置页，使用户能够配置 Microsoft Teams 应用，并使用它来配置个人、频道或群组聊天选项卡、消息传递扩展或连接器卡Microsoft 365 组。 你可以允许用户在安装后重新配置选项卡，并为应用程序创建选项卡删除页。 生成包含选项卡的 Teams 应用时，必须在 Android 和 iOS Teams 客户端上测试选项卡函数。 选项卡必须通过基本信息、区域设置、主题信息，以及标识选项卡中的内容的 entityId 或 subEntityId 来获取上下文。

注意

帖子和文件无法从其位置移动。

选项卡功能如下所示：

Scenario：在 Teams 中引入现有的基于 Web 的资源。 例子： 在 Teams 应用中创建一个静态选项卡，用于向用户显示一个信息性公司网站。

Scenario：向 Teams 机器人或消息传递扩展添加支持页面。 例子：创建静态选项卡，向用户提供有关和帮助网页内容。

Scenario：为协作对话和协作提供对用户定期交互的项目的访问权限。 Example：创建一个频道或组选项卡，其中包含各个项目的深层链接。

可以使用以下方法之一创建选项卡：

自定义选项卡在应用包的应用清单中声明。 对于要作为选项卡包含在应用中的每个网页，可以定义一个 URL 和一个范围。 此外，可以将 Teams JavaScript 客户端库 添加到页面，并在页面加载后调用 microsoftTeams.initialize() 。 Teams 显示你的页面并提供对 Teams 特定信息的访问权限，例如 Teams 客户端正在运行深色主题。

无论你选择在频道、组还是个人范围内公开选项卡，都必须在选项卡中显示 HTML 内容页 。对于静态选项卡，直接在 Teams 应用清单 中通过 contentUrl 数组中的 staticTabs 属性设置内容 URL。 选项卡的内容对于所有用户都是相同的。

注意

Teams 应用无法使用本机插件，因为它们在沙盒 iframe 中运行。

对于频道或组选项卡，还可以创建额外的配置页面。 此页允许配置内容页 URL，通常通过使用 URL 查询字符串参数加载该上下文的相应内容。 这是因为频道或组选项卡可以添加到多个团队或群组聊天。 每次后续安装时，用户都可以配置选项卡，以便根据需要定制体验。 当用户添加或配置选项卡时，URL 与 Teams 用户界面 (UI) 中显示的选项卡相关联。 配置选项卡只是向该 URL 添加更多参数。 例如，添加 Azure Boards 选项卡时，可选择配置页加载选项卡的哪个板。 配置页 URL 由configurationUrl应用清单中configurableTabs数组中的 属性指定。

对于静态选项卡，可以将 固定 contentUrl 到聊天或会议选项卡。 这允许跳过强制配置对话框，让用户更快地使用应用。 还可以在运行时更改 contentUrl 。 这允许你生成一个可在 Teams 的所有外围应用区域工作的选项卡对象。 有关详细信息，请参阅 将可配置选项卡迁移到静态选项卡。

可以有多个通道或组选项卡，每个应用最多可以有 16 个静态选项卡。

先决条件