文件AEM核心元件指南

快速搜尋元件(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

「快速搜尋元件」可讓網站訪客搜尋內容、就地檢視結果，並可輕鬆瀏覽至相符的頁面。 當使用者捲動搜尋結果時，則會動態擷取新的結果。

透過編輯對話框，內容作者可定義在內容樹狀結構中搜尋的開始位置。 使用設計對話框，範本作者可設定在內容樹狀結構中搜尋的開始位置預設值，以及最大結果集大小和最小搜尋字詞長度。

版本和相容性 version-and-compatibility

下表詳細說明該元件的所有支援版本、與元件版本相容的 AEM 版本，以及舊版文件的連結。

元件版本
AEM 6.4
AEM 6.5
AEM 6.5 LTS
AEM as a Cloud Service
v2
-
相容
相容
相容
v1
與
2.17.4 版及更早版本相容
相容
-
相容
CAUTION
本檔案說明快速搜尋元件v2。
如需「快速搜尋元件」目前版本的詳細資訊，請參閱快速搜尋元件文件。

如需核心元件版本和發行版本的進一步詳細資訊，請參閱核心元件版本文件。

技術詳細資訊 technical-details

NOTE
若要保護「搜尋元件」或任何以 AEM 為基礎的應用程式免受 DOS 攻擊，應在較高層級實施，例如透過在 Dispatcher 上使用 mod_security 。

在 GitHub 上可找到有關「快速搜尋元件」的最新技術文件。

如需開發「核心元件」的進一步詳細資訊，請參閱核心元件開發人員文件。

編輯對話框 edit-dialog

透過編輯對話框，內容作者可定義在內容樹狀結構中搜尋的開始位置。

快速搜尋元件的編輯對話框

搜尋根目錄 - 搜尋開始位置的根頁面。 「搜尋根目錄」可以是 Blueprint 主版頁面、語言主版頁面或一般頁面。

  • ID - 此選項可讓您控制 HTML 和「資料層」中元件的唯一識別碼。

    • 如果留空，則會自動產生唯一識別碼，您可以透過檢查得出的頁面找到該 ID。
    • 若已指定 ID，則作者應確保其為唯一識別碼。
    • 變更該 ID 會對 CSS、JS 和「資料層」追蹤造成影響。
NOTE
如果​ 搜尋根目錄 ​未設定或無法解析，則「快速搜尋」會預設為在目前頁面之下搜尋。

設計對話框 design-dialog

使用設計對話框，範本作者可以設定搜尋在內容樹狀結構中的開始位置預設值，以及結果集大小上限和搜尋字詞最小長度。設計對話框可讓範本作者定義可供內容作者使用的文字格式選項。

屬性索引標籤 properties-tab

快速搜尋元件的設計對話框

  • 搜尋根目錄
    內容作者在內容頁面上放置快速搜尋元件時，搜尋根目錄的預設值
  • 結果大小
    搜尋請求擷取的結果數量上限
  • 搜尋字詞最小長度
    開始搜尋的搜尋字詞最小長度
NOTE
結果大小​和​ 搜尋字詞最小長度 ​只能在設計模式下設定，因此僅限於範本層級，這表示內容作者無法修改這些值。
CAUTION
結果大小​和​ 搜尋字詞最小長度 ​如果分別設定得太高或太低，可能會影響效能。

樣式索引標籤 styles-tab

「快速搜尋元件」支援 AEM 樣式系統。

recommendation-more-help
experience-manager-core-components-help-main-toc