大网数据广告活动
Microsoft Graph 接口

Microsoft 服务中的人员Graph Toolkit

· 52CE 我爱测

可以使用 Web mgt-people 组件通过用户的照片或缩写显示一组人员或联系人。

可以使用 Web mgt-people 组件通过用户的照片或缩写显示一组人员或联系人。 默认情况下,它将显示已登录用户的最常见的联系人。

此组件使用多个 mgt-person 控件,但可以绑定到一组人员描述符。 如果要显示的人数多于 show-max 该值,将添加一个号码以指示其他联系人的数量。

示例

以下示例显示使用组件显示的一组 mgt-people 人员。 可以使用代码编辑器查看属性 如何 更改组件的行为。

<iframe src="https://mgt.dev/iframe.html?id=components-mgt-people--people&source=docs" height="350"></iframe>

在 mgt.dev 中打开此示例

属性

默认情况下,组件 mgt-people 通过筛选器 /me/people 从终结点提取 personType/class eq 'Person' 事件以显示经常联系的用户。 可以使用多个属性更改此行为。

属性 属性 说明
show-max showMax 指示要显示的最大人数。 默认值为 3。
people people 用于获取或设置组件呈现的联系人列表的一组人员。 使用此属性访问组件加载的人。 设置此值以加载您自己的人员。
group-id groupId 从特定 Microsoft Graph检索相应 ID 中的用户。
user-ids userIds 给定一组 Microsoft Graphids,组件将呈现这些用户。
人员查询 peopleQueries 给定一组人员查询 (、upns、电子邮件) ,组件将呈现这些用户。
person-card personCard 一个枚举,用于确定激活飞出面板所需的用户操作 - hover、 click或 none。 默认值为 hover。
show-presence showPresence 一个布尔值,用于确定是否在人像上显示个人状态锁屏提醒。
resource resource 从 Microsoft 获取的资源Graph (例如, /me/people) 。
scopes scopes 字符串的可选数组(如果使用 属性)或逗号分隔的范围(如果使用 属性)。 组件将使用这些作用域 (支持) ,以确保用户已同意适当的权限。
version version 进行 GET 请求时使用的可选 API 版本。 默认值为“v1.0”。
fallback-details fallbackDetails 在图中找不到用户/人员/联系人时,表示一个用户或多人的 IDynamicPerson 对象数组。

以下示例设置要显示的最大人数。

<mgt-people
  show-max="4">
</mgt-people>

CSS 自定义属性

组件 mgt-people 定义以下 CSS 自定义属性。

mgt-people {
  --list-margin: 8px 4px 8px 8px; /* Margin for component */
  --avatar-margin: 0 4px 0 0; /* Margin for each person */
  --color: #000000 /* Text color */
}

模板

支持mgt-people多个模板,您可以使用这些模板替换组件的某些部分。 若要指定模板,请包含 <template> 组件中的元素,将 data-type 值设置为以下值之一。

数据类型 数据上下文 说明
default people:人员对象列表 默认模板将整个组件替换为你自己的组件。
person person:person 对象 用于呈现每个人模板。
overflow people:人员对象列表 max:显示人数 extra:额外人员的数量 用于呈现超过人员列表右侧最大值的号码的模板。
no-data 不传递任何数据上下文 没有可用数据时所使用的模板。
loading 不传递任何数据上下文 组件加载状态时所使用的模板。

以下示例演示如何使用模板 person 。

<mgt-people>
  <template>
    <ul><li data-for="person in people">
      <mgt-person person-query="{{ person.userPrincipalName }}"></mgt-person>
      <h3>{{ person.displayName }}</h3>
      <p>{{ person.jobTitle }}</p>
      <p>{{ person.department }}</p>
    </li></ul>
  </template>
</mgt-people>

Microsoft Graph 权限

此组件使用下列 Microsoft Graph API 和权限:

配置 权限 API
groupId set GroupMember.Read.All /groups/${groupId}/members
userIds set User.ReadBasic.All /users/${userId}
peopleQueries set People.Read /me/people
resource set 中指定的权限 scopes 在 中指定 resource
默认配置 People.Read /me/people
showPresence set Presence.Read.All /communications/getPresencesByUserId

使用默认模板时,需要其他 API 和权限。 此组件的默认模板使用 mgt-person 组件。 有关所需权限的列表,请参阅其文档。

身份验证

该控件使用身份验证文档中介绍的全局 身份验证提供程序。

缓存

对象存储 缓存数据 备注
people 有关与查询匹配的人的信息 指定时 resource 使用
users 有关与查询匹配的用户的信息 在 、 groupId``userIds或未指定peopleQueries任何属性时使用
presence 指定人员集状态 设置为 时 showPresence 使用 true

Note: 默认情况下,组件 mgt-people 使用该 mgt-person 组件来显示有关人员的信息。 组件 mgt-person 自动下载并缓存每个人的照片。

若要详细了解如何配置缓存,请参阅Caching。

扩展以了解更多控件

对于更复杂的方案或真正自定义的 UX protected render* ,此组件公开了多个在组件扩展中替代的方法。

方法 说明
renderLoading 呈现加载状态。
renderNoData 呈现空数据状态。
renderPeople 呈现人员列表,最多呈现值 show-max 。
renderPerson 呈现单个人员。
renderOverflow 呈现值以外的剩余人的表示 show-max 形式。

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 sebastienlevert)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。