注意
Microsoft Graph Toolkit は非推奨です。 2025 年 9 月 1 日から、2026 年 8 月 28 日に完全な退職が予定されています。 開発者は、Web エクスペリエンスを構築するために、Microsoft Graph SDK またはその他のサポートされている Microsoft Graph ツールを使用して移行する必要があります。 詳細については、 非推奨のお知らせを参照してください。
検索ボックス コンポーネントは、機能の検索を可能にする入力コントロールをレンダリングします。 このコンポーネントは Microsoft Graph に接続されていないため、 検索結果コンポーネントと連携して使用する必要があります。
例
次の例は、 mgt-search-box コンポーネントを使用して、レンダリングのために他のコンポーネントに送信されるクエリをユーザーが入力できるようにする方法を示しています。 コード エディターを使用して、プロパティと属性がコンポーネントの動作をどのように変更させるかを確認することができます。
プロパティと属性
いくつかの属性を使用して、コンポーネントの動作を変更することができます。
| 属性 | プロパティ | 説明 |
|---|---|---|
| search-term | searchTerm | 検索用語の値。 |
| placeholder | placeholder | ピッカーでレンダリングされるプレースホルダー。 既定値は Search です。 |
| debounce-delay | debounceDelay | 検索入力の遅延をデバウンスします。 既定値は 300 です。 |
イベント
| イベント | いつ出力されるか | カスタム データ | キャンセル | 泡 | カスタム テンプレートを使用する |
|---|---|---|---|---|---|
searchTermChanged |
検索用語が変更されたときに発生します。 | string |
不要 | はい | 不要 |
イベントの処理の詳細については、「 イベント」を参照してください。
ローカリゼーション
コントロールは、ローカライズできる次の変数を公開します。 ローカライズを設定する方法の詳細については、「 コンポーネントのローカライズ」を参照してください。
| 文字列名 | 既定値 |
|---|---|
| placeholder | Search |
| title | Search |