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

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

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

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

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

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

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

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

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

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

• 다음을 참조하십시오 보안 검사 목록 - 개발 우수 사례 을 참조하십시오.

페이지:

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

단락 시스템:

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

AEM 구성 요소는 슬링.

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) - 자체 구성 요소를 정의하지 않는 하위 구성 요소에 대한 작성자 UI 측면을 제어합니다. cq:editConfig.

• 터치 지원 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:resourceType표준 Sling 콘텐츠 구조로서의

  • 속성을 가질 수 있음 helpPath 도움말 아이콘( ? 아이콘)을 선택합니다.

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

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

클래식 UI

• dialog ( cq:Dialog) 노드

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

  • 클래식 UI용

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

  • 속성 있음 xtype: ExtJS를 나타냅니다.

  • 속성을 가질 수 있음 helpPath 다음을 실행할 때 액세스되는 상황에 맞는 도움말 리소스(절대 또는 상대 경로)를 정의합니다. 도움말 버튼을 선택했습니다.

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

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

클래식 대화 상자 내에서:

• 다음과 같이 대화 상자를 만들 수 있습니다. cq:Dialog단일 탭을 제공하는 - 텍스트 구성 요소에서와 같이 또는 여러 탭이 필요한 경우 textimage 구성 요소에서와 같이 대화 상자를 정의할 수 있습니다. cq:TabPanel.
• a 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 전파됩니다.

계층 포함

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

이 계층은 디자이너에 의해 사용되며, 디자이너는 레이아웃 정보, 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:dropTargets, 유형 cq:DropTargetConfig; CRXDE Lite에서 쿼리 도구 ​ 사용하고 다음 XPath 쿼리 문자열 사용하여 검색할 수 있습니다.

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

xtype으로 정의된 구분 기호 tbseparator;

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

이름이 인 단추 댓글 관리 처리기 함수를 실행하는 경우 CQ_collab_forum_openCollabAdmin().