警告
Microsoft Graph 工具包已弃用。 停用期从 2025 年 9 月 1 日开始，计划于 2026 年 8 月 28 日完全停用。 开发人员应迁移到使用 Microsoft Graph SDK 或其他受支持的Microsoft Graph 工具来构建 Web 体验。 有关详细信息，请参阅 弃用公告。
搜索框组件呈现允许搜索功能的输入控件。 此组件未连接到 Microsoft Graph，应与 搜索结果组件协作使用。
示例
以下示例演示了如何使用 mgt-search-box 组件使用户能够键入将发送到其他组件进行呈现的查询。 可以使用代码编辑器查看 属性和属性 如何更改组件的行为。
属性和属性
可以使用多个属性来更改组件的行为。
| 属性 | 属性 | 说明 |
|---|---|---|
| search-term | searchTerm | 搜索词的值。 |
| 占 位 符 | 占 位 符 | 在选取器中呈现的占位符。 默认值为“Search”。 |
| debounce-delay | debounceDelay | 取消搜索输入的延迟。 默认值为“300”。 |
事件
| 事件 | 何时发出 | 自定义数据 | 可取消 | 泡沫 | 使用自定义模板 |
|---|---|---|---|---|---|
searchTermChanged |
更改搜索词时触发。 | string |
否 | 是 | 否 |
有关处理事件的详细信息，请参阅 事件。
本地化
控件公开以下可本地化的变量。 有关如何设置本地化的详细信息，请参阅 本地化组件。
| 字符串名称 | 默认值 |
|---|---|
| 占 位 符 | Search |
| title | Search |