Show Menu
TOPICS×

구성 요소 포함

핵심 구성 요소 포함 구성 요소를 사용하면 AEM 컨텐츠 페이지에 외부 컨텐츠를 포함할 수 있습니다.

사용량

핵심 구성 요소 포함 구성 요소를 사용하면 컨텐츠 작성자가 AEM 컨텐츠 페이지에 포함할 선택된 외부 컨텐츠를 정의할 수 있습니다. 또한 포함할 자유 형식 HTML을 정의하는 옵션이 있습니다.

버전 및 호환성

포함 구성 요소의 현재 버전은 v1이며, 이 버전은 2019년 9월 핵심 구성 요소 릴리스 2.7.0에서 도입되었으며 이 문서에 설명되어 있습니다.
다음 표에서는 구성 요소의 지원되는 모든 버전, 구성 요소 버전이 호환되는 AEM 버전 및 이전 버전에 대한 설명서 링크에 대해 자세히 설명합니다.
구성 요소 버전
AEM 6.3
AEM 6.4
AEM 6.5
v1
호환 가능
호환 가능
호환 가능
핵심 구성 요소 버전 및 릴리스에 대한 자세한 내용은 핵심 구성 요소 버전을 참조하십시오 .

샘플 구성 요소 출력

포함 구성 요소와 구성 옵션의 예 및 HTML 및 JSON 출력을 보려면 구성 요소 라이브러리를 참조하십시오 .

기술 정보

포함 구성 요소에 대한 최신 기술 문서는 GitHub에서 찾을 수 있습니다 .
핵심 구성 요소 개발에 대한 자세한 내용은 핵심 구성 요소 개발자 설명서를 참조하십시오.

구성 대화 상자

구성 대화 상자에서는 컨텐츠 작성자가 페이지에 포함할 외부 리소스를 정의할 수 있습니다. 먼저 포함할 리소스 유형을 선택합니다.

URL

가장 간단한 임베드란 URL입니다. URL 필드에 포함할 리소스의 URL을
붙여넣으면
됩니다. 구성 요소는 리소스에 액세스하려고 하며, 프로세서 중 하나에서 렌더링할 수 있는 경우 URL 필드 아래에 확인 메시지가
표시됩니다
. 그렇지 않으면 필드가 오류로 표시됩니다.
포함 구성 요소는 다음과 같은 유형의 리소스에 대해 프로세서와 함께 제공됩니다.
개발자는 내장 구성 요소의 개발자 설명서를 따라 추가 URL 프로세서를 추가할 수 있습니다.

포함 가능

임베드 변수를 사용하면 임베드된 리소스를 보다 맞춤화하여 매개 변수화할 수 있으며 추가 정보를 포함할 수 있습니다. 작성자는 미리 구성된 신뢰할 수 있는 포함 가능 항목 중에서 선택할 수 있으며 구성 요소는 기본 제공 가능한 Youtube와 함께 제공됩니다.
임베드
가능한
필드는 사용할 프로세서 유형을 정의합니다. YouTube 임베드 가능한 경우 다음을 정의할 수 있습니다.
  • 비디오
    ID - 포함할 리소스의 YouTube의 고유 비디오 ID
  • 너비
    - 포함된 비디오의 폭입니다.
  • 높이
    - 포함된 비디오의 높이
기타 임베드 파일은 유사한 필드를 제공하며 내장 구성 요소의 개발자 설명서를 따라 개발자가 정의할 수 있습니다.
페이지 작성자가 사용할 수 있도록 # 대화 상자를 통해 템플릿 수준에서 임베드 파일을 활성화해야 합니다.

HTML

포함 구성 요소를 사용하여 페이지에 자유 형식 HTML을 추가할 수 있습니다.
스크립트와 같은 안전하지 않은 태그는 입력한 HTML에서 필터링되며 결과 페이지에서 렌더링되지 않습니다.

보안

작성자가 입력할 수 있는 HTML 마크업은 작성자가 관리 권한을 얻을 수 있는 크로스 사이트 스크립팅 공격을 방지하기 위해 보안 목적으로 필터링됩니다.
일반적으로
모든 스크립트 및
style
요소뿐만 아니라 모든
on*
style
속성이 출력에서 제거됩니다.
하지만 포함 구성 요소는 에 나와 있는 AEM의 전역 HTML AntiSamy Fishing 프레임워크 필터링 규칙 세트를 따르기 때문에 규칙이 더 복잡해졌습니다.
/libs/cq/xssprotection/config.xml
필요한 경우 개발자가 프로젝트별 구성에 대해 오버레이할 수 있습니다.
추가 보안 정보는 AEM 개발자 문서에서 찾을 수 있습니다.
AntiSamy 위생 프레임워크 규칙은 오버레이로 구성할 수 있지만 이러한
/libs/cq/xssprotection/config.xml
변경 사항은 내장 코어 구성 요소뿐만 아니라 모든 HTL 및 JSP 동작에 영향을 줍니다.

디자인 대화 상자

템플릿 작성자는 디자인 대화 상자를 사용하여 포함 구성 요소를 사용하는 컨텐츠 작성자에게 사용 가능한 옵션과 포함 구성 요소를 배치할 때 설정된 기본값을 정의할 수 있습니다.
  • URL 비활성화
    -
    선택 시 컨텐츠 작성자에
    대한 URL 옵션을 비활성화합니다.
  • 포함 가능
    비활성화 - 임베드 가능한
    프로세서에 상관없이
    선택한 경우 컨텐츠 작성자에 대한 포함 가능 옵션을 비활성화합니다.
  • HTML 비활성화
    -
    선택 시 컨텐츠 작성자에
    대한 HTML 옵션을 비활성화합니다.
  • 임베드 가능
    - 임베드 가능한 프로세서가 활성 상태인 경우 컨텐츠 작성자가 사용할 수 있는 임베드 가능한 프로세서를 정의하는
    다중
    세그먼트입니다.