循环组件设计准则

Microsoft Loop组件是实时的、可操作的生产力单元，可保持同步并在 Microsoft 365 应用中自由移动。 它包括通过将现有自适应卡片演变为循环组件或创建新的基于自适应卡片的循环组件来创建循环组件的功能。

循环组件关键功能

实时：加载卡时（例如打开电子邮件或聊天时）时，自适应卡片必须进行自我更新，以反映最新信息。

嵌入：自适应卡片是嵌入式的，因此不需要任何特定内容。

可操作：循环组件允许用户执行操作以完成组件本身内的流;不只是查看信息或打开浏览器。 如果你的自适应卡片是仅查看体验，请寻找机会使其可操作，因为这是一个核心卡元素，让用户满意。 确保具有仅查看体验的自适应卡片不会更改为循环组件，在这种情况下，它必须仅保留为自适应卡片。

注意

组件的某些用户权限或模式可能不可操作，但常见情况必须可操作。

可以通过包括以下任何操作来使自适应卡片可操作：

• 批准支出报表
• 添加批注
• 更新日期
• 更新价格，例如美元金额
• 更改工作分配或状态值
• 添加或更新数据

可移植：在开发人员指南中根据需要添加 URL 属性可确保可以在支持基于自适应卡片的循环组件的任何位置实时复制组件。

属性	函数
住	卡中填充了最新信息。 如果有多个实例，则它们会随着更新而保持同步。
Embedded	卡片可以放入文档和对话中，这些文档和对话与其余内容分开。
可行	任务可以内联完成。
便携式	组件可以跨支持循环组件的 Microsoft 365 应用工作。

循环组件元素

基于自适应卡片的循环组件由正文、标头和边框组成。

循环组件元素	开发人员提供	平台提供
正文	完全由你控制的内容	基于代码呈现控件并设置控件样式。
Header	图标和名称	元素和布局是标准的，由平台提供
边框	不适用	所有循环组件的标准边框。

循环组件主体

循环组件主体使组件是唯一的。 你可以通过构建体现 Loop 组件属性并提供客户价值的组件来为用户提供积极的体验，并增加使用情况和保留率。

组件主体的详细信息取决于用户的需求和方案的具体细节。

以下是循环组件正文的最佳做法：

• 转到 自适应卡片主页 并查看 自适应卡片概述 一文，了解自适应卡片的基础知识和核心设计原则。
• 遵循 自适应卡片设计指南，其中包括工具、示例、有关响应式设计和像素密度的说明。
• 以下列表提供了特定于循环组件的注意事项：
  • 确保组件对循环组件属性（例如实时、可操作、嵌入式和可移植）为 true。
  • 不要添加单独的按钮以在浏览器中打开。
  • 不要添加重复的页眉或边框。

不要添加单独的按钮以在浏览器中打开

循环组件标头提供了一种标准方法，用于根据 URL 打开基于浏览器的组件视图。 因此，无需为组件添加单独的按钮即可执行“ 查看详细信息” 或 “在 Web 上打开”等操作。

可以为更具体的视图添加按钮或链接，例如 “查看相关项”。 如果可能，请在卡中提供所需的信息和交互。

不要添加重复的页眉或边框

所有循环组件都具有标准的标头和边框。 确保自适应卡片代码不得复制页眉和边框。 你可以为组件创建特定于项的标题，但请确保应用名称和图标不相同。

循环组件标头

该平台提供组件标头，并包括标准元素，例如应用徽标、应用名称、共享位置和副本。

计数器	说明
1	应用徽标: 应用的全色应用徽标。
2	应用名称：应用的全名。
3	共享位置 (循环控制)
4	复制组件

应用名称 是从组件协定中提取的。 建议对应用使用简明的名称。

应用徽标 是从组件协定中提取的。 确保提供的徽标适用于浅色和深色背景，因为同一资产用于 Microsoft Teams 中的浅色、深色和高对比度主题。

循环组件边框

组件边框将组件与组件周围的内容分开。 它可帮助用户了解循环组件是实时的，并且与它周围的内容（如电子邮件或聊天）分开。

边框会自动显示。

后续步骤

基于卡片的自适应循环组件