빠른 검색 구성 요소

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

사용량

빠른 검색 구성 요소는 사이트 방문자가 컨텐츠를 검색하고, 결과를 제자리에서 보고, 일치하는 페이지로 쉽게 이동할 수 있는 기능을 제공합니다. 사용자가 검색 결과를 스크롤할 때 새 결과를 동적으로 가져옵니다.

편집 대화 상자를 사용하면 컨텐츠 작성자가 컨텐츠 트리에서 검색이 시작되는 위치를 정의할 수 있습니다. 템플릿 작성자는 디자인 대화 상자를 사용하여 컨텐츠 트리에서 검색이 시작되어야 하는 위치에 대한 기본값과 최대 결과 집합 크기 및 최소 검색어 길이를 설정할 수 있습니다.

버전 및 호환성

빠른 검색 구성 요소의 현재 버전은 v1이며, 2018년 1월에 핵심 구성 요소 릴리스 2.0.0에서 도입되었으며, 이 문서에 설명되어 있습니다.

다음 표에서는 구성 요소의 지원되는 모든 버전, 구성 요소의 버전이 호환되는 AEM 버전 및 이전 버전에 대한 설명서 링크에 대해 자세히 설명합니다.

구성 요소 버전 AEM 6.4 AEM 6.5 AEM as a Cloud Service
v1 호환 가능 호환 가능 호환 가능

핵심 구성 요소 버전 및 릴리스에 대한 자세한 내용은 핵심 구성 요소 버전 문서를 참조하십시오.

기술 세부 정보

노트

DOS 공격으로부터 검색 구성 요소 또는 AEM 기반 애플리케이션을 보호하는 것은 예를 들어 디스패처에서 mod_security 을 사용하는 것보다 높은 수준에서 구현해야 합니다.

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

코어 구성 요소 개발에 대한 자세한 내용은 코어 구성 요소 개발자 설명서에서 확인할 수 있습니다.

편집 대화 상자

편집 대화 상자에서는 컨텐츠 작성자가 컨텐츠 트리에서 검색을 시작해야 하는 위치를 정의할 수 있습니다.

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

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

  • ID - 이 옵션을 사용하면 HTML 및 데이터 레이어에서 구성 요소의 고유 식별자를 제어할 수 있습니다.
    • 비워 두면 고유 ID가 자동으로 생성되며 결과 페이지를 검사하여 찾을 수 있습니다.
    • ID가 지정된 경우 ID가 고유한지 확인하는 것은 작성자의 책임입니다.
    • ID를 변경하면 CSS, JS 및 데이터 레이어 추적에 영향을 줄 수 있습니다.
노트

검색 루트​가 구성되어 있지 않거나 확인할 수 없는 경우, 빠른 검색은 현재 페이지 아래에서 기본적으로 검색됩니다.

디자인 대화 상자

템플릿 작성자는 디자인 대화 상자를 사용하여 컨텐츠 트리에서 검색이 시작되어야 하는 위치에 대한 기본값과 최대 결과 세트 크기 및 최소 검색 용어 길이를 설정할 수 있습니다.디자인 대화 상자에서는 컨텐츠 작성자가 사용할 수 있는 텍스트 형식 옵션을 정의할 수 있습니다.

속성 탭

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

  • 검색
    루트컨텐츠 작성자가 컨텐츠 페이지에 빠른 검색 구성 요소를 배치할 때 검색 루트의 기본값입니다
  • 결과
    크기 검색 요청으로 가져온 최대 결과 수입니다
  • 검색어 최소
    길이검색을 시작할 검색어의 최소 길이입니다
노트

결과 크기 및 검색어 최소 길이는 디자인 모드에서만 설정할 수 있으므로 템플릿 레벨에서만 설정할 수 있습니다. 즉, 컨텐츠 작성자는 이러한 값을 수정할 수 없습니다.

주의

결과 크기 및 검색어 최소 길이는 각각 너무 높거나 너무 낮게 설정된 경우 성능에 영향을 줄 수 있습니다.

스타일 탭

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

이 페이지에서는