快速搜尋元件 quick-search-component

「快速搜尋元件」提供網站搜尋功能,並會顯示搜尋結果,讓訪客可輕鬆找到相符的內容並檢視結果。

TIP
您是否考慮過適用於 AEM 的 Edge Delivery Services?
現有的專案可以繼續使用本文件中所述的方法。然而,針對新專案,Adobe 建議採用 Edge Delivery Services。

用途 usage

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

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

版本和相容性 version-and-compatibility

快速搜尋元件的目前版本為 v2,此版本於 2018 年 1 月隨著核心元件 2.18.0 版發行導入,詳情請參閱本文件。

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

元件版本
AEM 6.4
AEM 6.5
AEM 6.5 LTS
AEM as a Cloud Service
v2
-
相容
相容
相容
v1

2.17.4 版及更早版本相容
相容
-
相容

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

技術詳細資訊 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
d2be9096-a81e-404b-9952-d8925af7219c