快速搜尋元件 quick-search-component

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

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

用途 usage

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

編輯對話方塊可讓內容作者定義內容樹狀結構中開始搜尋的位置,並可選擇隱藏語意搜尋切換。 範本作者可以使用設計對話方塊,設定內容樹狀結構中搜尋開始位置的預設值、結果集大小上限、搜尋字詞長度下限,以及依預設是否向訪客顯示語意搜尋切換。

版本和相容性 version-and-compatibility

快速搜尋元件的目前版本是v3,此版本隨核心元件的發行版本2.32.0新增選用的語意搜尋切換而推出,本檔案將對此進行說明。

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

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

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

*語意搜尋切換僅適用於AEM as a Cloud Service。

如需核心元件版本的詳細資訊,請參閱檔案核心元件版本。

範例元件輸出 sample-component-output

若要體驗快速搜尋元件並檢視其設定選項範例以及HTML和JSON輸出,請造訪元件資料庫。

技術詳細資訊 technical-details

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

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

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

編輯對話框 edit-dialog

編輯對話方塊可讓內容作者定義內容樹狀結構中開始搜尋的位置,並可選擇隱藏語意搜尋切換按鈕。

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

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

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

    • 如果留空,則會自動產生唯一識別碼,您可以透過檢查得出的頁面找到該 ID。
    • 若已指定 ID,則作者應確保其為唯一識別碼。
    • 變更該 ID 會對 CSS、JS 和「資料層」追蹤造成影響。
  • 在此執行個體上隱藏語意搜尋切換 — 勾選後,無論設計對話方塊設定為顯示什麼,語意搜尋切換都會隱藏。

    • 取消勾選則使用範本的預設值。
    • 此選項無法強制切換顯示於設計對話方塊隱藏它的位置。
NOTE
如果​ 搜尋根目錄 ​未設定或無法解析,則「快速搜尋」會預設為在目前頁面之下搜尋。
NOTE
語意搜尋切換只有在環境已設定AEM Content AI時,才會傳回AI支援的結果。 在未設定Content AI的AEM 6.5和AEM 6.5 LTS環境中,使用設計對話方塊🔗隱藏切換,以免訪客使用無法運作的搜尋模式。

設計對話框 design-dialog

使用設計對話方塊,範本作者可以設定內容樹狀結構中開始搜尋的位置的預設值,以及結果集大小上限、搜尋字詞長度下限,以及依預設是否向訪客顯示語意搜尋切換。

屬性索引標籤 properties-tab

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

  • 搜尋根 — 內容作者在內容頁面上放置快速搜尋元件時,搜尋根的預設值

  • 結果大小 — 搜尋要求擷取的結果數目上限

  • 搜尋字詞最小長度 — 開始搜尋的搜尋字詞最小長度

  • 隱藏語意搜尋切換 — 勾選時,使用方式中描述的​ 語意搜尋 ​切換預設不會顯示給網站訪客,而且元件的行為類似於v2 (僅限全文檢索搜尋)元件。

    • 預設為未勾選。
    • 內容作者也可以在編輯對話方塊中覆寫個別快速搜尋元件的內容。
NOTE
語意搜尋切換只有在環境已設定AEM Content AI時,才會傳回AI支援的結果。 在未設定Content AI的AEM 6.5和AEM 6.5 LTS環境中,使用設計對話方塊隱藏切換,以免訪客使用無法運作的搜尋模式。
NOTE
結果大小​和​ 搜尋字詞最小長度 ​只能在設計模式下設定,因此僅限於範本層級,這表示內容作者無法修改這些值。
CAUTION
結果大小​和​ 搜尋字詞最小長度 ​如果分別設定得太高或太低,可能會影響效能。

樣式索引標籤 styles-tab

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

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