범용 편집기 사용자 정의 customizing

마지막 업데이트: 2025년 12월 16일

적용 대상:
Experience Manager as a Cloud Service

주제:
Developing

작성 대상:

Admin
Developer

콘텐츠 작성자의 요구 사항을 지원하도록 범용 편집기를 사용자 정의하는 다양한 옵션에 대해 알아봅니다.

TIP

범용 편집기는 또한 프로젝트 요구 사항을 충족하도록 기능을 확장할 수 있는 여러 확장 지점을 제공합니다.

Meta 구성 태그 사용 meta-tags

특정 작성 워크플로에서는 유니버설 편집기의 일부 기능을 사용해야 할 수 있으며 다른 기능은 사용해야 하지 않을 수 있습니다. 이러한 다양한 경우를 지원하기 위해 편집기의 특정 기능이나 버튼을 구성하거나 비활성화하는 데 메타 태그를 사용할 수 있습니다.

기능 비활성화 disable-features

페이지의 <head> 섹션에서 이 태그를 사용하여 하나 이상의 기능을 비활성화하십시오.

<meta name="urn:adobe:aue:config:disable" content="..." />

여러 기능을 비활성화하려면 쉼표로 구분된 값 목록을 제공합니다.

다음은 content에 대해 지원되는 값, 즉 메타 태그를 사용하여 비활성화할 수 있는 기능입니다.

컨텐츠 값

설명

publish

모든 게시 기능, 즉 게시 단추 및 게시 취소 단추 사용 안 함

publish-live

라이브 게시 사용 안 함

publish-preview

미리 보기 게시 비활성화(미리 보기 서비스를 사용할 수 있는 경우)

unpublish

게시 취소 단추 사용 안 함

copy

복사 및 붙여넣기 단추를 사용하지 않도록 설정합니다.

duplicate

중복 단추를 사용하지 않도록 설정합니다.

header-open-page

페이지 열기 단추를 사용하지 않도록 설정합니다.

aem-dev-login

개발자 로그인 단추를 사용하지 않도록 설정합니다.

편집기 모드 정의 defining-mode

특정 모드에서 유니버설 편집기를 강제로 열 수 있습니다. 페이지의 <head> 섹션에서 이 태그를 사용하여 편집기 모드를 적용하십시오.

<meta name="urn:adobe:aue:config:mode" content="..." />

다음은 content에 대해 지원되는 값, 즉 메타 태그를 사용하여 비활성화할 수 있는 기능입니다.

컨텐츠 값

설명

preview

편집기가 미리 보기 모드에서 열립니다. 미리 보기 아이콘이 숨겨져 있으므로 사용자가 편집 모드로 다시 전환할 수 없습니다.

readonly

편집기가 읽기 전용 모드로 열립니다. 속성 단추와 패널이 숨겨져 있습니다. 콘텐츠 트리에서 세부 사항을 사용할 수 있지만 변경할 수 없습니다.

메타 태그를 통해 모드를 정의할 때 사용자가 모드를 재정의할 수 없습니다.

사용자 정의 미리보기 URL custom-preview-urls

편집기의 오른쪽 상단 도구 모음에서 페이지 열기 버튼을 클릭할 때 열리는 urn:adobe:aue:config:preview 메타 구성을 통해 사용자 정의 미리보기 URL을 지정할 수 있습니다.

이렇게 하려면 다음 예시와 같이 계측된 앱의 메타 태그에 원하는 미리보기 URL을 포함하면 됩니다.

<meta name="urn:adobe:aue:config:preview" content="https://wknd.site"/>

엔드포인트 변경 custom-endpoint

Adobe에서 호스팅하는 범용 편집기 서비스를 사용하지 않고 자체 호스팅 버전을 사용하려면 메타 태그에서 이 설정을 지정할 수 있습니다. 자세한 내용은 AEM에서 범용 편집기 시작하기 문서를 참조하십시오.

필터링 구성 요소 filtering-components

범용 편집기에서 구성 요소 필터를 사용하여 컨테이너당 허용되는 구성 요소를 제한할 수 있습니다. 자세한 내용은 필터링 구성 요소 문서를 참조하십시오.

속성 패널에서 구성 요소를 조건부로 표시 및 숨기기 conditionally-hide

일반적으로 작성자가 사용할 수 있는 구성 요소가 하나 이상 있더라도 적합하지 않은 특정 상황이 있을 수 있습니다. 이러한 경우 구성 요소 모델의 필드에 condition 속성을 추가하여 속성 패널에서 구성 요소를 숨길 수 있습니다.

조건은 JsonLogic 스키마를 사용하여 정의할 수 있습니다. 조건이 true이면 필드가 표시됩니다. 조건이 false이면 필드가 숨겨집니다.

샘플 모델

code language-json

 {
    "id": "conditionally-revealed-component",
    "fields": [
      {
        "component": "boolean",
        "label": "Shall the text field be revealed?",
        "name": "reveal",
        "valueType": "boolean"
      },
      {
        "component": "text-input",
        "label": "Hidden text field",
        "name": "hidden-text",
        "valueType": "string",
        "condition": { "===": [{"var" : "reveal"}, true] }
      }
    ]
 }

조건 False

조건 True

제한 사항: 다중 필드 컨테이너 내의 조건 conditions-multi-field-limitation

조건 var 해상도가 현재 행에 상대적이지 않고 절대적입니다. var은(는) 루트 수준 fieldName이거나 컨테이너 이름이 containerName|fieldName(으)로 접두사로 추가된 컨테이너 내부 필드의 경우 이어야 합니다.

다중 컨테이너(반복 가능한 행)에 대해서는 동일한 접근 방식이 작동하지 않습니다. 행 콘텐츠는 런타임에 containerName/0|fieldName, containerName/1|fieldName 등으로 인덱싱되지만, 조건을 작성할 때 해당 인덱스를 알 수 없으며 행이 추가, 제거 또는 재정렬됨에 따라 변경됩니다. 따라서 작성자가 동일한 행 내의 특정 필드를 타깃팅할 수 있는 방법이 없으므로 다중 컨테이너 내의 조건은 지원되지 않습니다.

recommendation-more-help

experience-manager-cloud-service-help-main-toc