구성 요소 포함

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

사용량

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

버전 및 호환성

포함 구성 요소의 현재 버전은 v1이며, 2019년 9월 핵심 구성 요소 릴리스 2.7.0에 도입되었으며 이 문서에 설명되어 있습니다.

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

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

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

샘플 구성 요소 출력

구성 옵션과 HTML 및 JSON 출력의 예를 보고 포함 구성 요소를 경험하려면 구성 요소 라이브러리를 방문하십시오.

기술 세부 정보

포함 구성 요소 에 대한 최신 기술 문서는 GitHub에서 찾을 수 있습니다.

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

구성 대화 상자

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

임베드 가능한 각 유형에 대해 광고 ID​를 정의할 수 있습니다. 이 옵션을 사용하면 HTML 및 데이터 레이어에서 구성 요소의 고유 식별자를 제어할 수 있습니다.

  • 비워 두면 자동으로 고유 ID가 생성되며 결과 페이지를 검사하여 찾을 수 있습니다.
  • ID가 지정된 경우 작성자는 ID가 고유한지 확인해야 합니다.
  • ID를 변경하면 CSS, JS 및 데이터 레이어 추적에 영향을 줄 수 있습니다.

URL

가장 간단한 임베드 방법은 URL입니다. URL 필드에 포함할 리소스의 URL을 붙여넣으면 됩니다. 구성 요소가 리소스에 액세스하려고 하며 프로세서 중 하나에서 렌더링할 수 있는 경우 URL 필드 아래에 확인 메시지가 표시됩니다. 그렇지 않으면 필드가 오류로 표시됩니다.

포함 구성 요소는 다음 유형의 리소스에 대해 프로세서와 함께 제공됩니다.

  • Facebook 게시물, Instagram, SoundCloud, Twitter 및 YouTube를 포함한 Embed 표준을 준수하는 리소스
  • Pinterest

개발자는 포함 구성 요소의 개발자 설명서에 따라 에 의해 추가 URL 프로세서를 추가할 수 있습니다.

URL에 대한 구성 요소의 편집 대화 상자 포함

포함 가능

포함 가능 항목을 사용하면 포함된 리소스를 보다 사용자 지정할 수 있으며, 매개 변수화할 수 있고 추가 정보를 포함할 수 있습니다. 작성자는 미리 구성된 신뢰할 수 있는 포함 가능 항목 중에서 선택할 수 있으며 구성 요소는 기본적으로 포함되어 있는 YouTube 포함 가능한 out-of-the-box와 함께 제공됩니다.

포함 가능 필드는 사용할 프로세서 유형을 정의합니다. YouTube 임베드 가능한 경우 다음을 정의할 수 있습니다.

  • 비디오 ID - 포함할 리소스의 YouTube에서 고유한 비디오 ID
  • 너비 - 포함된 비디오의 폭입니다.
  • 높이 - 포함된 비디오의 높이입니다.
  • 음소거 활성화 - 이 매개 변수는 기본적으로 비디오가 음소거 재생되는지 여부를 지정합니다. 이를 활성화하면 자동 재생이 최신 브라우저에서 작동할 가능성이 높아집니다.
  • 자동 재생 활성화 - 이 매개 변수는 플레이어가 로드될 때 초기 비디오가 자동으로 재생되는지 여부를 지정합니다. 이 옵션은 게시 인스턴스에만 적용되거나 제작 인스턴스에서 게시됨으로 보기 옵션을 사용할 때만 적용됩니다.
  • 루프 활성화 - 단일 비디오의 경우 이 매개 변수는 플레이어가 초기 비디오를 반복적으로 재생할지 여부를 지정합니다. 재생 목록의 경우 플레이어가 전체 재생 목록을 재생한 다음 첫 번째 비디오에서 다시 시작합니다.
  • 인라인 재생 활성화(iOS) - 이 매개 변수는 iOS에서 비디오가 HTML5 플레이어에서 인라인(온) 또는 전체 화면(꺼짐)으로 재생되는지 여부를 제어합니다.
  • 무제한 관련 비디오 - 이 옵션을 사용하지 않으면 관련 비디오가 방금 재생된 비디오와 동일한 채널에서 나오며 그렇지 않으면 모든 채널에서 나옵니다.

"enable" 옵션은 디자인 대화 상자를 통해 활성화해야 하고 기본값으로 설정할 수 있습니다.

다른 포함 파일은 유사한 필드를 제공하며 포함 구성 요소의 개발자 설명서에 따라 개발자가 정의할 수 있습니다.

포함 파일에 대한 구성 요소의 편집 대화 상자 포함

노트

페이지 작성자가 사용할 수 있도록 디자인 대화 상자를 통해 템플릿 수준에서 임베드 파일을 활성화해야 합니다.

HTML

포함 구성 요소를 사용하여 페이지에 자유 형식의 HTML을 추가할 수 있습니다.

HTML에 대한 구성 요소의 편집 대화 상자 포함

노트

스크립트와 같은 안전하지 않은 태그는 입력한 HTML에서 필터링되며 결과 페이지에서 렌더링되지 않습니다.

보안

작성자가 입력할 수 있는 HTML 마크업은 작성자가 관리 권한을 얻을 수 있는 크로스 사이트 스크립팅 공격을 방지하기 위해 보안 목적으로 필터링됩니다.

일반적으로 모든 스크립트 및 style 요소뿐만 아니라 모든 on*style 속성이 출력에서 제거됩니다.

그러나 포함 구성 요소는 /libs/cq/xssprotection/config.xml에서 찾을 수 있는 AEM 전역 HTML AntiSamy Furishing 프레임워크 필터링 규칙 세트를 따르기 때문에 규칙은 더 복잡합니다. 필요한 경우 개발자가 프로젝트 특정 구성을 위해 이를 오버레이할 수 있습니다.

추가 보안 정보는 Cloud Service 설치로서 AEM뿐만 아니라 온-프레미스 설치AEM 개발자 문서에서 찾을 수 있습니다.🔗

노트

/libs/cq/xssprotection/config.xml을(를) 오버레이하여 AntiSamy 위생 프레임워크 규칙을 구성할 수 있지만 이러한 변경 사항은 내장 코어 구성 요소만이 아니라 모든 HTL 및 JSP 동작에 영향을 줍니다.

디자인 대화 상자

템플릿 작성자는 디자인 대화 상자를 통해 포함 구성 요소를 사용할 때 기본 설정값과 포함 구성 요소를 사용할 컨텐츠 작성자가 사용할 수 있는 옵션을 정의할 수 있습니다.

포함 가능한 유형 탭

구성 요소의 디자인 대화 상자 포함

  • URL 비활성화 - 선택 시 컨텐츠 작성자에 ​대한 URL 옵션을 비활성화합니다.
  • 포함 가능 비활성화 - 임베드 가능한 ​프로세서에 상관없이 선택한 경우 컨텐츠 작성자에 대한 포함 가능 옵션을 비활성화합니다.
  • HTML 비활성화 - 선택 시 컨텐츠 작성자에 ​대한 HTML 옵션을 비활성화합니다.
  • 임베드 가능 - 임베드 가능한 프로세서를 정의하는 다중 선택이며, 임베디드 ​선택 옵션이 활성 상태임.

YouTube 탭

포함 구성 요소의 디자인 대화 상자의 YouTube 탭

  • 음소거 비헤이비어 구성 허용 - YouTube 포함 유형 을 선택한 경우 컨텐츠 작성자가 구성 요소에서 다중 사용 옵션을 구성할 수 있습니다.
    • 음소거 기본값 - YouTube 포함 유형 을 선택한 경우 [다중 사용] 옵션을 자동으로 설정합니다.
  • 자동 재생 동작 구성 허용 - YouTube 포함 유형을 선택할 때 컨텐츠 작성자가 구성 요소에서 자동 레이아웃 활성화 옵션을 구성할 수 있습니다.
    • 자동 재생 기본값 - YouTube 포함 유형 이 선택되면 자동 레이아웃 활성화를 자동으로 설정합니다.
  • 루프 동작 구성 허용 - YouTube 포함 유형을 선택할 때 컨텐츠 작성자가 구성 요소에서 반복 사용 옵션을 구성할 수 있습니다.
    • 루프 기본값 - YouTube 포함 유형 을 선택한 경우 반복 사용 옵션을 자동으로 설정합니다.
  • 인라인 재생 구성 허용(iOS) - YouTube 포함 유형을 선택할 때 컨텐츠 작성자가 구성 요소 에서 인라인 재생 사용(iOS) 옵션을 구성할 수 있습니다.
    • 인라인 재생 기본값(iOS) - YouTube 포함 유형을 선택할 때 인라인 재생 사용(iOS) 옵션을 자동으로 설정합니다.
  • 인라인 비디오 구성 허용 - YouTube 포함 유형을 선택할 때 컨텐츠 작성자가 구성 요소 에서 무제한 관련 비디오 옵션을 구성할 수 있습니다.
    • 무제한 관련 비디오의 기본값 - YouTube 포함 유형 을 선택한 경우 무제한 관련 비디오 옵션이 자동으로 설정됩니다.

이 페이지에서는

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now