속성 및 유형

Universal Editor에 필요한 데이터 속성 및 유형에 대해 알아봅니다.

소개

Universal Editor에서 앱을 편집할 수 있으려면 앱이 적절하게 구성되어야 합니다. 여기에는 편집기가 앱의 콘텐츠를 편집하는 데 필요한 적절한 메타데이터가 포함됩니다. 이 문서는 이러한 메타데이터의 속성과 유형에 대해 자세히 설명합니다.

노트

콘텐츠 유효성 검사는 서버측에서 수행됩니다. Universal Editor는 단순히 데이터 속성을 이용합니다. 모델/구조에 맞는지 확인하는 유효성 검사는 API 수준에서 처리해야 합니다.

데이터 속성

데이터 속성 설명
itemid 리소스에 대한 URN은 AEM에서 Universal Editor 시작하기 문서의 페이지 계측 섹션을 참조하십시오.
itemprop 리소스의 속성은 AEM에서 Universal Editor 시작하기 문서의 페이지 계측 섹션을 참조하십시오.
itemtype 편집 가능한 항목의 유형 (예: 텍스트, 이미지, 참조 등)
data-editor-itemfilter 사용할 수 있는 참조 정의
data-editor-itemlabel 편집기에 표시되는 선택 가능한 항목에 대한 사용자 정의 레이블 정의
itemmodel이 설정된 경우 레이블은 모델을 통해 검색
data-editor-itemmodel 속성 레일에서 양식 기반 편집에 사용될 모델 정의
data-editor-behavior 계측의 동작 정의 (예: 독립 실행형 텍스트 또는 이미지는 구성 요소를 모방하여 이동하거나 삭제 가능)

항목 유형

itemtype 설명 itemid itemprop data-editor-itemfilter data-editor-itemlabel data-editor-itemmodel data-editor-behvior
text 텍스트는 HTML 태그 내에서 편집할 수 있지만 간단한 텍스트 형식으로만 사용할 수 있으며 서식 있는 텍스트 형식(예: 제목 구성 요소에 일반적으로 사용되는 텍스트 형식)은 사용 불가 선택 사항 필수 해당 없음 선택 사항 해당 없음 선택 사항
richtext 전체 서식 있는 텍스트 기능으로 텍스트 편집 가능. RTE는 오른쪽 편집기 패널에 표시됨 선택 사항 필수 해당 없음 선택 사항 해당 없음 선택 사항
media 편집 가능 항목은 에셋(예: 이미지 또는 비디오)임 선택 사항 필수 선택 사항
에셋 선택기로 전달되는 이미지 또는 비디오 필터 조건 목록		 선택 사항 해당 없음 선택 사항
container 편집 가능 항목은 단락 시스템이라는 구성 요소의 컨테이너 역할을 합니다. 상황에 따라 다름
아래 참조		 상황에 따라 다름
아래 참조		 선택 사항
허용된 구성 요소 목록		 선택 사항 해당 없음 해당 없음
component 편집 가능 항목은 구성 요소입니다. 추가 기능을 추가하지 않으며, DOM의 이동/삭제 가능한 부분을 표시하고 속성 레일 및 해당 필드를 여는 데 필요 필수 해당 없음 해당 없음 선택 사항 선택 사항 해당 없음
reference 편집 가능 항목은 참조(예: 콘텐츠 조각, 경험 조각 또는 제품)임 상황에 따라 다름
아래 참조		 상황에 따라 다름
아래 참조		 선택 사항
콘텐츠 조각, 제품 또는 참조 선택기에 전달되는 경험 조각 필터 조건 목록		 선택 사항 선택 사항 해당 없음

사용 사례에 따라 다름 itemprop 또는 itemid가 필요할 수도 있고 필요하지 않을 수도 있습니다. 예:

  • GraphQL을 통해 콘텐츠 조각을 쿼리하고 상황에 따라 목록을 편집할 수 있도록 하려면 itemid가 필요합니다.
  • 참조된 콘텐츠 조각의 콘텐츠를 렌더링하는 구성 요소가 있고 구성 요소 내에서 참조를 업데이트하려는 경우 itemprop이 필요합니다.

동작

data-editor-behavior 설명
component 독립 실행형 텍스트, 서식 있는 텍스트 및 미디어 모방 구성 요소를 허용하여 페이지에서 이동 및 삭제할 수 있도록 하는 데 사용 가능

추가 리소스

Universal Editor에 대해 자세히 알아보려면 다음 문서를 참조하십시오.

  • Universal Editor 소개 - Universal Editor를 사용하면 모든 구현에서 콘텐츠의 모든 측면을 편집할 수 있기 때문에 뛰어난 경험을 제공하고, 콘텐츠 속도를 높이고, 최신 개발자 경험을 제공할 수 있다는 점에 대해 알아봅니다.
  • Universal Editor로 콘텐츠 작성 - 콘텐츠 작성자가 Universal Editor를 사용하여 콘텐츠를 만드는 것이 얼마나 쉽고 직관적인지 알아봅니다.
  • Universal Editor로 콘텐츠 게시 - Universal Visual Editor에서 콘텐츠를 게시하는 방법과 앱에서 게시된 콘텐츠를 처리하는 방법에 대해 알아봅니다.
  • AEM에서 Universal Editor 시작하기 - Universal Editor에 액세스하는 방법과 이를 사용하기 위해 첫 번째 AEM 앱 계측을 시작하는 방법을 알아봅니다.
  • Universal Editor 아키텍처 - Universal Editor의 아키텍처 및 해당 서비스와 계층 간에 데이터가 흐르는 방식에 대해 알아봅니다.
  • Universal Editor 인증 - Universal Editor의 인증 방법에 대해 알아봅니다.

이 페이지에서는