빠른 검색 구성 요소 quick-search-component

빠른 검색 구성 요소는 웹 사이트에 검색 기능을 제공하고, 방문자가 일치하는 콘텐츠를 쉽게 검색하고 결과를 조회할 수 있도록 검색 결과를 제공합니다.

TIP
AEM용 Edge Delivery Services를 고려해 보셨습니까?
이 문서에 설명된 방법은 기존 프로젝트에도 계속 사용할 수 있습니다. 하지만 새로운 프로젝트의 경우 Adobe는 Edge Delivery Services를 활용할 것을 권장합니다.

사용량 usage

빠른 검색 구성 요소는 사이트 방문자를 대상으로 콘텐츠를 검색하고, 결과를 즉시 조회하고 일치하는 페이지로 간단히 이동하는 기능을 제공합니다. 사용자가 검색 결과를 스크롤하면 새 결과가 자동으로 나타납니다.

콘텐츠 작성자는 편집 대화 상자를 통해 콘텐츠 트리에서 검색이 시작되는 위치를 정의하고 선택적으로 의미 체계 검색 전환을 숨길 수 있습니다. 템플릿 작성자는 디자인 대화 상자를 사용하여 콘텐츠 트리에서 검색이 시작되는 위치, 최대 결과 집합 크기, 최소 검색어 길이 및 시맨틱 검색 토글이 기본적으로 방문자에게 표시되는지 여부에 대한 기본값을 설정할 수 있습니다.

버전 및 호환성 version-and-compatibility

현재 버전의 빠른 검색 구성 요소는 선택적 의미 체계 검색 토글을 추가하는 핵심 구성 요소의 릴리스 2.32.0과(와) 함께 도입된 v3입니다. 이 문서에서는 해당 구성 요소에 대해 설명합니다.

다음 테이블에서 구성 요소의 모든 지원 버전, 구성 요소 버전과 호환되는 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 공격으로부터 보호하는 경우 발송자의 mod_security를 사용하여 상위 수준에서 이를 구현해야 합니다.

빠른 검색 구성 요소 에 대한 최신 기술 설명서는 GitHub에서 확인할 수 있습니다.

핵심 구성 요소 개발에 대한 자세한 내용은 핵심 구성 요소 개발자 설명서를 참조하십시오.

편집 대화 상자 edit-dialog

콘텐츠 작성자는 편집 대화 상자를 통해 콘텐츠 트리에서 검색이 시작되는 위치를 정의하고 원할 경우 시맨틱 검색 토글을 숨길 수 있습니다.

빠른 검색 구성 요소의 편집 대화 상자

검색 루트 - 검색이 시작되는 위치의 루트 페이지. 검색 루트는 블루프린트 마스터, 언어 습득 또는 일반 페이지가 될 수 있습니다.

  • ID - 이 옵션을 통해 HTML과 데이터 레이어에서 구성 요소의 고유 식별자를 제어할 수 있습니다.

    • 비워 두면 고유 ID는 자동으로 생성되고 결과 페이지 검사를 통해 발견될 수 있습니다.
    • ID가 지정된 경우 작성자는 ID가 고유한지 확인해야 합니다.
    • ID가 변경되면 CSS, JS 및 데이터 레이어 추적에 영향을 미칠 수 있습니다.
  • 이 인스턴스에서 의미 체계 검색 토글 숨기기 - 확인 표시가 되어 있으면 디자인 대화 상자가 표시하도록 구성된 내용에 관계없이 의미 체계 검색 토글이 숨겨집니다.

    • 템플릿의 기본값을 사용하려면 선택하지 않은 상태로 둡니다.
    • 이 옵션을 사용하면 디자인 대화 상자가 숨기는 위치에 토글을 강제로 표시할 수 없습니다.
NOTE
검색 루트​를 구성하거나 해결할 수 없는 경우 빠른 검색은 기본적으로 현재 페이지의 검색으로 설정됩니다.
NOTE
시맨틱 검색 토글 은 환경이 AEM 콘텐츠 AI로 구성된 경우 AI 기반 결과만 반환합니다. 콘텐츠 AI로 구성되지 않은 AEM 6.5 및 AEM 6.5 LTS 환경에서 방문자에게 작동하지 않는 검색 모드가 제공되지 않도록 디자인 대화 상자를 사용하여 토글을 숨깁니다.

디자인 대화 상자 design-dialog

템플릿 작성자는 디자인 대화 상자 를 통해 콘텐츠 트리에서 검색이 시작되는 위치, 최대 결과 크기와 최소 검색어 길이, 시맨틱 검색 토글이 방문자에게 기본적으로 표시되는지 여부에 대한 기본값을 설정할 수 있습니다.

속성 탭 properties-tab

빠른 검색 구성 요소의 디자인 대화 상자

NOTE
시맨틱 검색 토글 은 환경이 AEM 콘텐츠 AI로 구성된 경우 AI 기반 결과만 반환합니다. 컨텐츠 AI로 구성되지 않은 AEM 6.5 및 AEM 6.5 LTS 환경에서는 디자인 대화 상자를 통해 토글을 숨기므로 방문자에게 작동하지 않는 검색 모드가 제공되지 않습니다.
NOTE
디자인 모드와 템플릿 수준에서만 결과 크기​와 최소 검색어 길이​를 설정할 수 있습니다. 단, 콘텐츠 작성자는 해당 값을 수정할 수 없습니다.
CAUTION
결과 크기​와 최소 검색어 길이​가 너무 길거나 짧게 설정되면 성능에 영향을 미칠 수 있습니다.

스타일 탭 styles-tab

빠른 검색 구성 요소는 AEM 스타일 시스템을 지원합니다.

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