Adobe Experience Manager(AEM) 구성 요소 - 기본 사항 aem-components-the-basics

새 구성 요소를 사용하려면 정확히 어떤 작업이 필요합니까?

• 명확한 사양은 개발, 테스트 및 인수의 모든 단계에 도움이 됩니다. 세부 사항은 시간이 지남에 따라 변경될 수 있지만 세부 사항은 업데이트할 수 있습니다(변경 사항도 문서화되어야 함).

구성 요소를 처음부터 만들어야 합니까? 또는 기존 구성 요소에서 기본 사항을 상속할 수 있습니까?

• 시간을 낭비할 필요가 없다.
• AEM에서 제공하는 메커니즘에는 재정의, 오버레이 및 Sling 리소스 병합을(를) 포함하여 다른 구성 요소 정의에서 세부 정보를 상속하고 확장할 수 있는 몇 가지 메커니즘이 있습니다.

콘텐츠를 선택하거나 조작하기 위해 구성 요소에 논리가 필요합니까?

• 논리는 사용자 인터페이스 레이어와 별도로 유지되어야 합니다. HTL은 이러한 일이 발생하는지 확인할 수 있도록 설계되었습니다.

구성 요소에 CSS 서식이 필요합니까?

• CSS 서식은 구성 요소 정의와 별도로 유지해야 합니다. 외부 CSS 파일을 통해 수정할 수 있도록 HTML 요소의 이름을 지정하는 규칙을 정의합니다.

어떤 보안 측면을 고려해야 합니까?

• 자세한 내용은 보안 검사 목록 - 개발 모범 사례를 참조하세요.

페이지:

• AEM에 page 구성 요소(cq:Page)가 있습니다.
• 이는 콘텐츠 관리에 중요한 특정 유형의 리소스입니다.
  • 페이지는 웹 사이트의 콘텐츠가 들어 있는 웹 페이지에 해당합니다.

단락 시스템:

• 단락 시스템은 단락 목록을 관리하기 때문에 웹 사이트의 주요 부분입니다. 실제 콘텐츠를 보관하는 개별 구성 요소를 보관하고 구성하는 데 사용됩니다.
• 단락 시스템에서 단락을 작성, 이동, 복사 및 삭제할 수 있습니다.
• 특정 단락 시스템 내에서 사용할 수 있는 구성 요소를 선택할 수도 있습니다.
• 표준 인스턴스(예: parsys, [responsivegrid](/docs/experience-manager-65/sites-authoring/responsive-layout.md)) 내에서 다양한 단락 시스템을 사용할 수 있습니다.

AEM 구성 요소는 Sling을(를) 기반으로 합니다.

AEM 구성 요소는 (일반적으로) 다음 아래에 있습니다.

• HTL: /libs/wcm/foundation/components
• JSP: /libs/foundation/components

프로젝트/사이트별 구성 요소는 (일반적으로) 아래에 있습니다.

• /apps/<myApp>/components

AEM 표준 구성 요소는 cq:Component(으)로 정의되어 있으며 다음과 같은 주요 요소를 가지고 있습니다.

• jcr 속성:

  jcr 속성 목록입니다. 이러한 속성은 변수이며, 구성 요소 노드의 기본 구조, 해당 속성 및 하위 노드가 cq:Component 정의에 의해 정의되어 있지만 일부는 선택 사항입니다

• 리소스:

  구성 요소에서 사용하는 정적 요소를 정의합니다.

• 스크립트:

구성 요소의 결과 인스턴스 동작을 구현하는 데 사용됩니다.

루트 노드:

• <mycomponent> (cq:Component) - 구성 요소의 계층 노드.

중요 속성:

• jcr:title - 구성 요소 제목. 예를 들어 구성 요소가 구성 요소 브라우저 또는 사이드 킥에 나열될 때 레이블로 사용됩니다.

• jcr:description - 구성 요소에 대한 설명. 구성 요소 브라우저 또는 사이드 킥에서 마우스 오버 힌트로 사용할 수 있습니다.

• 클래식 UI:

  • icon.png - 이 구성 요소의 아이콘입니다.
  • thumbnail.png - 이 구성 요소가 단락 시스템 내에 나열되면 표시되는 이미지

• Touch UI

  • 자세한 내용은 Touch UI의 구성 요소 아이콘 섹션을 참조하십시오.

중요한 하위 노드:

• cq:editConfig (cq:EditConfig) - 구성 요소의 편집 속성을 정의하고 구성 요소를 구성 요소 브라우저 또는 Sidekick에 표시할 수 있습니다.

  참고: 구성 요소에 대화 상자가 있으면 cq:editConfig가 없어도 구성 요소 브라우저 또는 Sidekick에 자동으로 표시됩니다.

• cq:childEditConfig (cq:EditConfig) - 자체 cq:editConfig을(를) 정의하지 않는 하위 구성 요소에 대한 작성자 UI 측면을 제어합니다.

• 터치 지원 UI:

  • cq:dialog( nt:unstructured) - 이 구성 요소에 대한 대화 상자. 사용자가 구성 요소를 구성 및/또는 콘텐츠를 편집할 수 있는 인터페이스를 정의합니다.
  • cq:design_dialog( nt:unstructured) - 이 구성 요소의 디자인 편집 중

• 클래식 UI:

  • dialog( cq:Dialog) - 이 구성 요소에 대한 대화 상자. 사용자가 구성 요소를 구성하거나, 콘텐츠를 편집하거나, 둘 다 편집할 수 있는 인터페이스를 정의합니다.
  • design_dialog( cq:Dialog) - 이 구성 요소에 대한 디자인 편집 중

HTL( /libs/wcm/foundation/components/text)

JSP( /libs/foundation/components/text)

cq:editConfig( cq:EditConfig) - 시각적 측면을 제어합니다. 예를 들어 막대 또는 위젯의 모양을 정의하거나 사용자 지정된 컨트롤을 추가할 수 있습니다

cq:childEditConfig( cq:EditConfig) - 자체 정의가 없는 자식 구성 요소의 시각적 측면을 제어합니다.

터치 지원 UI:

• cq:dialog( nt:unstructured) - 이 구성 요소의 콘텐츠를 편집하기 위한 대화 상자를 정의합니다.
• cq:design_dialog( nt:unstructured) - 이 구성 요소의 디자인 편집 옵션을 지정합니다.

클래식 UI:

• dialog( cq:Dialog) - 이 구성 요소의 콘텐츠를 편집하기 위한 대화 상자를 정의합니다(클래식 UI에만 해당).
• design_dialog( cq:Dialog) - 이 구성 요소의 디자인 편집 옵션을 지정합니다.
• icon.png - Sidekick에서 구성 요소의 아이콘으로 사용할 그래픽 파일
• thumbnail.png - Sidekick에서 구성 요소를 드래그하는 동안 구성 요소의 썸네일로 사용할 그래픽 파일

터치 지원 UI

• cq:dialog( nt:unstructured) 노드:

  • 이 구성 요소의 콘텐츠를 편집하기 위한 대화 상자 정의

  • 터치 지원 UI별

  • granite UI 구성 요소를 사용하여 정의됩니다

  • 표준 Sling 콘텐츠 구조로서 sling:resourceType 속성이 있습니다.

  • 속성 helpPath을(를) 사용하여 도움말 아이콘(? 아이콘)을 선택할 때 액세스하는 상황에 맞는 도움말 리소스(절대 또는 상대 경로)를 정의할 수 있습니다.

    • 기본 구성 요소의 경우 이 기능은 종종 설명서의 페이지를 참조합니다.
    • helpPath을(를) 지정하지 않으면 기본 URL(설명서 개요 페이지)이 표시됩니다.

대화 상자 내에서 개별 필드가 정의됩니다.

클래식 UI

• dialog( cq:Dialog) 노드

  • 이 구성 요소의 콘텐츠를 편집하기 위한 대화 상자 정의

  • 클래식 UI용

  • ExtJS 위젯을 사용하여 정의됩니다

  • ExtJS를 참조하는 xtype 속성이 있습니다.

  • 도움말 단추를 선택할 때 액세스하는 상황에 맞는 도움말 리소스(절대 또는 상대 경로)를 정의하는 속성 helpPath이(가) 있을 수 있습니다.

    • 기본 구성 요소의 경우 이 기능은 종종 설명서의 페이지를 참조합니다.
    • helpPath을(를) 지정하지 않으면 기본 URL(설명서 개요 페이지)이 표시됩니다.

대화 상자 내에서 개별 필드가 정의됩니다.

클래식 대화 상자 내에서:

• 텍스트 구성 요소에서와 같이 단일 탭을 제공하는 대화 상자를 cq:Dialog(으)로 만들거나, textimage 구성 요소에서와 같이 여러 탭이 필요한 경우 대화 상자를 cq:TabPanel(으)로 정의할 수 있습니다.
• cq:WidgetCollection( items)은(는) 입력 필드( cq:Widget) 또는 추가 탭( cq:Widget)의 기준을 제공하는 데 사용됩니다. 이 계층은 확장할 수 있습니다.

터치 지원 UI

클래식 UI

두 UI에 대한 정의에 name= ./jcr:title 속성이 있습니다.

• /libs/foundation/components/title/cq:dialog/content/items/column/items/title
• /libs/foundation/components/title/dialog/items/title

콘텐츠 내에서 작성자의 콘텐츠를 포함하는 속성 jcr:title이(가) 생성됩니다.

리소스 유형 계층 구조

속성 sling:resourceSuperType을(를) 사용하여 구성 요소를 확장하는 데 사용됩니다. 이렇게 하면 구성 요소가 상속될 수 있습니다. 예를 들어 텍스트 구성 요소는 표준 구성 요소에서 다양한 속성을 상속합니다.

• 스크립트(Sling으로 해결됨)
• 대화 상자
• 설명(썸네일 이미지 및 아이콘 포함)

컨테이너 계층

이 메서드는 하위 구성 요소에 대한 구성 설정을 채우는 데 사용되며 parsys 시나리오에서 가장 일반적으로 사용됩니다.

예를 들어 편집 막대 단추, 컨트롤 세트 레이아웃(편집 막대, 롤오버), 대화 상자 레이아웃(인라인, 부동)에 대한 구성 설정을 상위 구성 요소에서 정의하고 하위 구성 요소로 전파할 수 있습니다.

cq:editConfig 및 cq:childEditConfig의 구성 설정(편집 기능 관련)이 전파되었습니다.

계층 포함

이는 다음을 포함하는 순서에 따라 런타임에 적용됩니다.

이 계층은 Designer에서 사용되며, 레이아웃 정보, css 정보 및 parsys의 사용 가능한 구성 요소를 포함하여 렌더링의 다양한 디자인 측면에 대한 기반 역할을 합니다.

cq:editConfig 노드 속성:

• cq:actions( String array): 구성 요소에서 수행할 수 있는 작업을 정의합니다.

• cq:layout( String): 클래식 UI에서 구성 요소를 편집하는 방법을 정의합니다.

• cq:dialogMode( String): 구성 요소 대화 상자를 클래식 UI에서 여는 방법을 정의합니다

  • 터치 지원 UI에서 대화 상자는 항상 데스크탑 모드에서 부동이며 모바일에서 전체 화면으로 자동으로 열립니다.

• cq:emptyText( String): 시각적 컨텐츠가 없을 때 표시되는 텍스트를 정의합니다.

• cq:inherit( Boolean): 누락된 값이 상속되는 구성 요소에서 상속되는지 여부를 정의합니다.

• dialogLayout(문자열): 대화 상자를 여는 방법을 정의합니다.

cq:editConfig개의 하위 노드:

• cq:dropTargets(노드 유형 nt:unstructured): 콘텐츠 파인더의 에셋에서 삭제를 수락할 수 있는 삭제 대상 목록을 정의합니다.

  • 여러 놓기 대상은 클래식 UI에서만 사용할 수 있습니다.
  • 터치 활성화 UI에서는 단일 드롭 대상이 허용됩니다.

• cq:actionConfigs(노드 유형 nt:unstructured): cq:actions 목록에 추가되는 새 작업 목록을 정의합니다.

• cq:formParameters(노드 유형 nt:unstructured): 대화 상자 양식에 추가되는 추가 매개 변수를 정의합니다.

• cq:inplaceEditing(노드 유형 cq:InplaceEditingConfig): 구성 요소에 대한 즉석 편집 구성을 정의합니다.

• cq:listeners(노드 유형 cq:EditListenersConfig): 구성 요소에서 작업이 발생하기 전이나 후에 수행되는 작업을 정의합니다.

cq:editConfig 노드의 속성(예: cq:actions)을 찾으려면 CRXDE Lite ​에서 쿼리 도구를 사용하고 다음 XPath 쿼리 문자열로 검색할 수 있습니다.

//element(cq:editConfig, cq:EditConfig)[@cq:actions]

예를 들어 cq:editConfig의 자식 노드를 찾으려면 cq:DropTargetConfig 유형의 cq:dropTargets을(를) 검색하고 ​ CRXDE Lite에서 쿼리 도구를 사용하여 다음 XPath 쿼리 문자열 검색할 수 있습니다.

//element(cq:dropTargets, cq:DropTargetConfig)

xtype tbseparator(으)로 정의된 구분 기호

• 클래식 UI에서만 사용됩니다.
• xtype이 무시되므로 터치 사용 UI에서 이 정의는 무시됩니다. (작업 도구 모음이 터치 사용 UI에서 다르게 구성되므로 구분 기호는 필요하지 않음).

처리기 함수 CQ_collab_forum_openCollabAdmin()을(를) 실행하는 댓글 관리 단추.