注意
Microsoft Graph Toolkit は非推奨です。 2025 年 9 月 1 日から、2026 年 8 月 28 日に完全な退職が予定されています。 開発者は、Web エクスペリエンスを構築するために、Microsoft Graph SDK またはその他のサポートされている Microsoft Graph ツールを使用して移行する必要があります。 詳細については、非推奨のお知らせを参照してください
注:
このコンポーネントはプレビュー段階にあり、変更される可能性があります。 運用アプリケーションでのこれらのコンポーネントの使用はサポートされていません。 このコンポーネントは現在、React コンポーネントとしてのみ使用でき、Web コンポーネントと同等のコンポーネントはありません。
新しいチャット コンポーネントを使用すると、ユーザーはMicrosoft Teamsで新しい 1:1 またはグループ会話を作成できます。
例
次の例では、 mgt-new-chat コンポーネントを使用して新しいチャット フォームを表示します。
[プロパティ]
| 属性 | プロパティ | 説明 |
|---|---|---|
| mode | mode |
oneOnOne、group、またはautoに設定します。 既定値は auto です。 |
<NewChat mode="group" />
CSS カスタム プロパティ
mgt-new-chat コンポーネントでは、CSS カスタム プロパティは定義されません。
イベント
コンポーネントから次のイベントが発生します。
| イベント | いつ出力されるか | カスタム データ | キャンセル | 泡 | カスタム テンプレートを使用する |
|---|---|---|---|---|---|
onChatCreated |
新しいチャット スレッドが作成されたときに発生します。 | Microsoft Graph チャットとして作成されたchat オブジェクト。 |
不要 | 不要 | 不要 |
onCancelClicked |
ユーザーがチャット スレッドの作成をキャンセルしたときに発生します。 | なし | 不要 | 不要 | 不要 |
イベントの処理の詳細については、「 イベント」を参照してください。
テンプレート
mgt-new-chat コンポーネントには、オーバーライドするテンプレートは用意されていません。
Microsoft Graph のアクセス許可
このコントロールは、以下の Microsoft Graph API とアクセス許可を使用します。
| 構成 | アクセス許可 | API |
|---|---|---|
| 既定値 | Chat.Create、ChatMessage.Send | /chats, /chats/{id}/messages |
サブコンポーネント
mgt-new-chat コンポーネントは、前に示したアクセス許可以外のアクセス許可を必要とする可能性がある 1 つ以上のサブコンポーネントで構成されます。 詳細については、各サブコンポーネントのドキュメントを参照してください。 mgt-people-picker。
認証
tasks コンポーネントは、 認証ドキュメントで説明されているグローバル認証プロバイダーを使用します。
キャッシュ
mgt-new-chat コンポーネントはデータをキャッシュしません。
ローカリゼーション
mgt-new-chat コンポーネントでは、ローカライズ変数は公開されません。
既知の問題
-
mgt-new-chatコンポーネントはテーマをサポートしていないため、ブラウザーの設定を尊重しません。