快速搜索组件(v2) quick-search-component

最近更新： 2026年8月18日

创建对象：

{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

快速搜索组件提供对网站的搜索功能并显示搜索结果，以便访客能够轻松找到匹配内容并查看结果。

用途 usage

利用快速搜索组件，网站访客能够搜索内容、就地查看结果和轻松导航到匹配页面。在用户滚动浏览搜索结果时，将动态获取新结果。

利用“编辑”对话框，内容作者可以定义内容树中开始搜索的位置。利用“设计”对话框，模板作者可以设置内容树中开始搜索的位置的默认值，以及最大结果集大小和最小搜索词长度。

下表详细说明了该组件的所有受支持版本、与该组件的版本兼容的 AEM 版本以及指向早期版本文档的链接。

组件版本

AEM 6.4

AEM 6.5

AEM 6.5 LTS

AEM as a Cloud Service

兼容

与
版本 2.17.4 和更低版本兼容

兼容

CAUTION

本文档介绍了快速搜索组件v2。
有关当前版本的快速搜索组件的详细信息，请参阅快速搜索组件文档。

有关核心组件版本的更多信息，请参阅文档核心组件版本。

NOTE

应对搜索组件或任何基于 AEM 的应用程序实施更高级别的保护以使其免受 DOS 攻击，例如，通过使用 Dispatcher 上的 mod_security。

在 GitHub 上可找到有关快速搜索组件的最新技术文档。

在核心组件开发人员文档中可找到有关开发核心组件的其他详细信息。

利用“编辑”对话框，内容作者可以定义内容树中开始搜索的位置。

快速搜索组件的“编辑”对话框

搜索根 - 要从其开始搜索的根页面。搜索根可以是 Blueprint 母版页、语言母版页或常规页。

ID - 利用此选项，可以控制 HTML 和Data Layer 中的组件的唯一标识符。
- 如果留空，系统会自动为您生成一个唯一 ID，可以通过检查结果页面找到该 ID。
- 如果指定一个 ID，作者有责任确保它是唯一的。
- 更改此 ID 会对 CSS、JS 和 Data Layer 跟踪产生影响。

NOTE

如果 搜索根 未配置或无法解析，则快速搜索默认为在当前页面下搜索。