빠른 검색 구성 요소 quick-search-component
빠른 검색 구성 요소는 웹 사이트에 검색 기능을 제공하고, 방문자가 일치하는 콘텐츠를 쉽게 검색하고 결과를 조회할 수 있도록 검색 결과를 제공합니다.
사용량 usage
빠른 검색 구성 요소는 사이트 방문자를 대상으로 콘텐츠를 검색하고, 결과를 즉시 조회하고 일치하는 페이지로 간단히 이동하는 기능을 제공합니다. 사용자가 검색 결과를 스크롤하면 새 결과가 자동으로 나타납니다.
콘텐츠 작성자는 편집 대화 상자를 통해 콘텐츠 트리에서 검색이 시작되는 위치를 정의하고 선택적으로 의미 체계 검색 전환을 숨길 수 있습니다. 템플릿 작성자는 디자인 대화 상자를 사용하여 콘텐츠 트리에서 검색이 시작되는 위치, 최대 결과 집합 크기, 최소 검색어 길이 및 시맨틱 검색 토글이 기본적으로 방문자에게 표시되는지 여부에 대한 기본값을 설정할 수 있습니다.
버전 및 호환성 version-and-compatibility
현재 버전의 빠른 검색 구성 요소는 선택적 의미 체계 검색 토글을 추가하는 핵심 구성 요소의 릴리스 2.32.0과(와) 함께 도입된 v3입니다. 이 문서에서는 해당 구성 요소에 대해 설명합니다.
다음 테이블에서 구성 요소의 모든 지원 버전, 구성 요소 버전과 호환되는 AEM 버전 및 이전 버전에 대한 설명서 링크에 대해 자세히 살펴볼 수 있습니다.
*시맨틱 검색 토글은 AEM as a Cloud Service에서만 사용할 수 있습니다.
핵심 구성 요소 버전 및 릴리스에 대한 자세한 내용은 문서 핵심 구성 요소 버전을 참조하십시오.
샘플 구성 요소 출력 sample-component-output
빠른 검색 구성 요소를 경험하고 구성 옵션의 샘플뿐만 아니라 HTML 및 JSON 출력을 확인하려면 구성 요소 라이브러리를 참조하십시오.
기술 세부 정보 technical-details
mod_security를 사용하여 상위 수준에서 이를 구현해야 합니다.빠른 검색 구성 요소 에 대한 최신 기술 설명서는 GitHub에서 확인할 수 있습니다.
핵심 구성 요소 개발에 대한 자세한 내용은 핵심 구성 요소 개발자 설명서를 참조하십시오.
편집 대화 상자 edit-dialog
콘텐츠 작성자는 편집 대화 상자를 통해 콘텐츠 트리에서 검색이 시작되는 위치를 정의하고 원할 경우 시맨틱 검색 토글을 숨길 수 있습니다.
검색 루트 - 검색이 시작되는 위치의 루트 페이지. 검색 루트는 블루프린트 마스터, 언어 습득 또는 일반 페이지가 될 수 있습니다.
-
ID - 이 옵션을 통해 HTML과 데이터 레이어에서 구성 요소의 고유 식별자를 제어할 수 있습니다.
- 비워 두면 고유 ID는 자동으로 생성되고 결과 페이지 검사를 통해 발견될 수 있습니다.
- ID가 지정된 경우 작성자는 ID가 고유한지 확인해야 합니다.
- ID가 변경되면 CSS, JS 및 데이터 레이어 추적에 영향을 미칠 수 있습니다.
-
이 인스턴스에서 의미 체계 검색 토글 숨기기 - 확인 표시가 되어 있으면 디자인 대화 상자가 표시하도록 구성된 내용에 관계없이 의미 체계 검색 토글이 숨겨집니다.
- 템플릿의 기본값을 사용하려면 선택하지 않은 상태로 둡니다.
- 이 옵션을 사용하면 디자인 대화 상자가 숨기는 위치에 토글을 강제로 표시할 수 없습니다.
디자인 대화 상자 design-dialog
템플릿 작성자는 디자인 대화 상자 를 통해 콘텐츠 트리에서 검색이 시작되는 위치, 최대 결과 크기와 최소 검색어 길이, 시맨틱 검색 토글이 방문자에게 기본적으로 표시되는지 여부에 대한 기본값을 설정할 수 있습니다.
속성 탭 properties-tab
-
검색 루트 - 콘텐츠 작성자가 콘텐츠 페이지에 빠른 검색 구성 요소를 배치하는 경우의 검색 루트 기본값
-
결과 크기 - 검색 요청에서 가져온 최대 결과 수
-
최소 검색어 길이 - 검색을 시작하는 최소 검색어 길이
-
시맨틱 검색 전환 숨기기 - 확인 표시가 되어 있으면 사용에 설명된 시맨틱 검색 전환이 기본적으로 사이트 방문자에게 표시되지 않으며 구성 요소는 v2(전체 텍스트 검색 전용) 구성 요소와 같이 작동합니다.
- 기본적으로 선택되지 않습니다.
- 콘텐츠 작성자는 편집 대화 상자에서 개별 빠른 검색 구성 요소에 대해 이 설정을 재정의할 수도 있습니다.