警告
Microsoft Graph 工具包已弃用。 停用期从 2025 年 9 月 1 日开始,计划于 2026 年 8 月 28 日完全停用。 开发人员应迁移到使用 Microsoft Graph SDK 或其他受支持的Microsoft Graph 工具来构建 Web 体验。 有关详细信息,请参阅 弃用公告
注意
此组件处于预览状态,随时可能更改。 不支持在生产应用程序中使用这些组件。 此组件目前仅作为React组件提供,没有等效的 Web 组件。
新的聊天组件允许用户在 Microsoft Teams 中创建新的 1:1 或群组对话。
示例
以下示例使用 mgt-new-chat 组件显示新的聊天表单。
属性
| 属性 | 属性 | 说明 |
|---|---|---|
| mode | mode | 将 设置为 oneOnOne或 groupauto。 默认值为“auto”。 |
<NewChat mode="group" />
CSS 自定义属性
组件 mgt-new-chat 不定义 CSS 自定义属性。
事件
从 组件触发以下事件。
| 事件 | 何时发出 | 自定义数据 | 可取消 | 泡沫 | 使用自定义模板 |
|---|---|---|---|---|---|
onChatCreated |
创建新聊天线程时触发。 |
chat创建为 Microsoft Graph 聊天的对象。 |
否 | 否 | 否 |
onCancelClicked |
当用户取消聊天线程创建时触发。 | None | 否 | 否 | 否 |
有关处理事件的详细信息,请参阅 事件。
模板
组件 mgt-new-chat 不提供任何要替代的模板。
Microsoft Graph 权限
此控件使用以下Microsoft Graph API 和权限。
| 配置 | 权限 | API |
|---|---|---|
| 默认值 | Chat.Create、ChatMessage.Send | /chats、 /chats/{id}/messages |
子组件
组件 mgt-new-chat 由一个或多个子组件组成,这些子组件可能需要除前面列出的权限以外的其他权限。 有关详细信息,请参阅每个子组件的文档: mgt-people-picker。
身份验证
任务组件使用身份验证文档中所述的全局 身份验证提供程序。
缓存
组件 mgt-new-chat 不缓存任何数据。
本地化
组件 mgt-new-chat 不公开任何本地化变量。
已知问题
- 该
mgt-new-chat组件不支持主题设置,并且不会遵循浏览器首选项。