Microsoft Graph 工具包概述

Microsoft Graph 工具包 是可重复使用、与框架 无关的组件和身份认证提供程序的集合,用于访问和使用 Microsoft Graph。 这些组件开箱即可正常运行,附带的内置提供程序可以与 Microsoft Graph 进行身份验证并从之提取数据。

Microsoft Graph 工具包 可以使得在应用程序中使用 Microsoft Graph 变得轻松。 在以下示例中,使用 LoginAgenda 组件,仅显示两行代码的已登录用户及其日历事件。

为何使用 Microsoft Graph 工具包?

借助 Microsoft Graph 工具包,可以快速轻松地将 Microsoft Graph 支持的常见体验集成到自己的应用程序中。 工具包:

  • 缩短开发时间。 连接到 Microsoft Graph API 并在外观类似于 Microsoft 365 体验的 UI 中呈现数据的工作已为你完成,无需自定义。

  • 无处不在。 所有组件都基于 Web 标准,可与任何新式浏览器和 Web 框架 ((如 React、Angular 或 Vue) )无缝协作。

  • 美丽但灵活。 这些组件的外观与 Microsoft 365 体验类似,但也可使用 CSS 自定义属性模板进行自定义。

谁应该使用它?

Microsoft Graph 工具包非常适合所有经验级别的开发人员,这些开发人员希望开发一个连接到 Microsoft Graph 并从访问数据的应用,例如:

  • Web 应用
  • Microsoft Teams 选项卡
  • 渐进式 Web 应用 (PWA)
  • 电子应用
  • SharePoint Web 部件

Microsoft Graph 工具包中有哪些内容?

组件

Microsoft Graph 工具包包含一系列 Web 组件,用于由 Microsoft Graph API 提供支持的最常见生成体验。

这些组件还可作为 React 组件 使用。

组件 说明
议程 显示用户或组日历中的事件。
聊天 (预览) 显示 Microsoft Teams 中的 1:1 或群组对话
文件 表示具有图标、文件名、作者等的文件或文件夹。
文件列表 显示多个文件或文件夹的列表。
获取 允许直接在 HTML 中对任何 Microsoft 图形 API进行 GET 查询。
登录 一个按钮和一个浮出控件,用于使用 Microsoft 标识平台对用户进行身份验证,并在用户登录时显示用户的个人资料信息。
新的聊天 (预览) 在 Microsoft Teams 中创建新的 1:1 或群组对话的窗体
人员 按照照片或首字母缩写显示一组人员或联系人。
人员选取器 搜索人员并呈现结果列表。
人员 通过照片、姓名和/或电子邮件地址显示人员或联系人。
个人卡片 用于显示有关用户的更多个人资料信息的人员组件上的浮出控件。
选取器 呈现一个下拉列表控件,该控件允许从资源数组中选择单个资源。
规划器任务 显示并启用添加、删除、完成或编辑 Microsoft Planner 或微软待办中的任务。
搜索框 搜索 Microsoft Teams 频道,从呈现的结果列表中选择频道。
搜索结果 允许直接在 HTML 中查询 Microsoft Graph 的搜索终结点。
分类选取器 使用分类选取器组件查询 Microsoft 图形 API的分类,并使用术语呈现下拉列表控件。
Teams 频道选取器 搜索 Microsoft Teams 频道,从呈现的结果列表中选择频道。
待办事项 显示并启用添加、删除、完成或编辑微软待办中的任务。

提供程序

提供程序 启用身份验证,提供用于在各种平台上获取访问令牌的实现,并公开用于调用 Microsoft Graph API 的 Microsoft Graph 客户端。 组件在与提供程序一起使用时效果最佳,但提供程序也可以自行使用。

提供程序 说明
自定义 创建一个自定义提供程序,以使用应用程序的现有身份验证代码启用对 Microsoft Graph 的身份验证和访问。
电子 对 Electron 应用内的组件进行身份验证并提供 Microsoft Graph 访问权限。
MSAL2 使用 msal-browser 登录用户并获取用于 Microsoft Graph 的令牌。
代理 通过后端将所有调用路由到 Microsoft Graph 以允许使用后端身份验证。
SharePoint 对 SharePoint Web 部件中的组件进行身份验证并提供对组件的 Microsoft Graph 访问权限。
TeamsFx 使用 Microsoft Teams 应用程序内的 TeamsFx 提供程序提供对 Microsoft Graph 的 Microsoft Graph 工具包组件访问权限。

在哪里可以使用它?

以下浏览器支持 Microsoft Graph 工具包:

Microsoft Edge Firefox Chrome Safari Opera Samsung Internet
Microsoft Edge Firefox Chrome Safari Opera Samsung

后续步骤

  • 样本中试用组件。
  • Microsoft Graph 工具包入门
  • 查看 GitHub 上的 Microsoft Graph 工具包。