구성 요소 기본 사항 component-basics

이 장에서는 간단한 HelloWorld 예제를 통해 Adobe Experience Manager(AEM) Sites 구성 요소의 기본 기술을 살펴보겠습니다. 작성, HTL, 슬링 모델, 클라이언트측 라이브러리 등의 주제를 다루는 기존 구성 요소는 약간 수정됩니다.

사전 요구 사항 prerequisites

로컬 개발 환경을 설정하는 데 필요한 도구 및 지침을 검토하십시오.

비디오에 사용된 IDE는 Visual Studio CodeVSCode AEM Sync 플러그인입니다.

목표 objective

  1. HTML을 동적으로 렌더링하기 위한 HTL 템플릿 및 Sling 모델의 역할에 대해 알아봅니다.
  2. 콘텐츠 작성을 용이하게 하기 위해 대화 상자를 사용하는 방법을 이해합니다.
  3. 구성 요소를 지원하기 위해 CSS 및 JavaScript을 포함하는 클라이언트측 라이브러리의 기본 사항에 대해 알아봅니다.

빌드할 항목 what-build

이 장에서는 간단한 HelloWorld 구성 요소를 몇 가지 수정합니다. HelloWorld 구성 요소를 업데이트하는 동안 AEM 구성 요소 개발의 주요 영역에 대해 알아봅니다.

챕터 스타터 프로젝트 starter-project

이 장은 AEM Project Archetype에서 생성한 일반 프로젝트를 기반으로 합니다. 시작하려면 아래 비디오를 보고 필수 구성 요소를 검토하세요!

NOTE
이전 장을 성공적으로 완료한 경우 프로젝트를 재사용하고 스타터 프로젝트 체크 아웃 단계를 건너뛸 수 있습니다.

새 명령줄 터미널을 열고 다음 작업을 수행합니다.

  1. 빈 디렉터리에서 aem-guides-wknd 리포지토리를 복제합니다.

    code language-shell
    $ git clone git@github.com:adobe/aem-guides-wknd.git --branch tutorial/component-basics-start --single-branch
    
    note note
    NOTE
    필요한 경우 이전 장 프로젝트 설정에서 생성된 프로젝트를 계속 사용할 수 있습니다.
  2. aem-guides-wknd 폴더로 이동합니다.

    code language-shell
    $ cd aem-guides-wknd
    
  3. 다음 명령을 사용하여 AEM의 로컬 인스턴스에 프로젝트를 빌드하고 배포합니다.

    code language-shell
    $ mvn clean install -PautoInstallSinglePackage
    
    note note
    NOTE
    AEM 6.5 또는 6.4를 사용하는 경우 classic 프로필을 Maven 명령에 추가합니다.
    code language-shell
    $ mvn clean install -PautoInstallSinglePackage -Pclassic
    
  4. 로컬 개발 환경을 설정하는 지침에 따라 프로젝트를 원하는 IDE로 가져옵니다.

구성 요소 작성 component-authoring

구성 요소는 웹 페이지의 작은 모듈식 빌딩 블록으로 생각할 수 있습니다. 구성 요소를 재사용하려면 구성 요소를 구성할 수 있어야 합니다. 이 작업은 작성자 대화 상자를 통해 수행됩니다. 다음으로 간단한 구성 요소를 작성하고 대화 상자의 값이 AEM에서 어떻게 유지되는지 검사해 보겠습니다.

다음은 위 비디오에서 수행되는 높은 수준의 단계입니다.

  1. WKND 사이트 > US > en 아래에 구성 요소 기본 사항(이)라는 페이지를 만듭니다.
  2. Hello World 구성 요소 ​를 새로 만든 페이지에 추가합니다.
  3. 구성 요소의 대화 상자를 열고 텍스트를 입력합니다. 변경 사항을 저장하여 페이지에 표시되는 메시지를 확인합니다.
  4. 개발자 모드로 전환하고 CRXDE-Lite에서 컨텐츠 경로를 보고 구성 요소 인스턴스의 속성을 검사합니다.
  5. CRXDE-Lite를 사용하여 /apps/wknd/components/content/helloworld에서 cq:dialoghelloworld.html 스크립트를 봅니다.

HTL(HTML 템플릿 언어) 및 대화 상자 htl-dialogs

HTML 템플릿 언어 또는 HTL ​은(는) AEM 구성 요소에서 콘텐츠를 렌더링하는 데 사용하는 가벼운 서버측 템플릿 언어입니다.

대화 상자 ​는 구성 요소에 사용할 수 있는 구성을 정의합니다.

다음으로 HelloWorld HTL 스크립트를 업데이트하여 텍스트 메시지 앞에 추가 인사말을 표시하겠습니다.

다음은 위 비디오에서 수행되는 높은 수준의 단계입니다.

  1. IDE로 전환하고 프로젝트를 ui.apps 모듈로 엽니다.

  2. helloworld.html 파일을 열고 HTML 마크업을 업데이트합니다.

  3. 파일 변경 내용을 로컬 AEM 인스턴스와 동기화하려면 VSCode AEM 동기화와 같은 IDE 도구를 사용하십시오.

  4. 브라우저로 돌아가서 구성 요소 렌더링이 변경되었는지 확인합니다.

  5. 다음 위치에서 HelloWorld 구성 요소에 대한 대화 상자를 정의하는 .content.xml 파일을 엽니다.

    code language-plain
    <code>/aem-guides-wknd/ui.apps/src/main/content/jcr_root/apps/wknd/components/helloworld/_cq_dialog/.content.xml
    
  6. 대화 상자를 업데이트하여 이름이 ./titleTitle 추가 텍스트 필드를 추가하십시오.

    code language-xml
    <?xml version="1.0" encoding="UTF-8"?>
    <jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:cq="http://www.day.com/jcr/cq/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0"
        jcr:primaryType="nt:unstructured"
        jcr:title="Properties"
        sling:resourceType="cq/gui/components/authoring/dialog">
        <content
            jcr:primaryType="nt:unstructured"
            sling:resourceType="granite/ui/components/coral/foundation/fixedcolumns">
            <items jcr:primaryType="nt:unstructured">
                <column
                    jcr:primaryType="nt:unstructured"
                    sling:resourceType="granite/ui/components/coral/foundation/container">
                    <items jcr:primaryType="nt:unstructured">
                        <title
                            jcr:primaryType="nt:unstructured"
                            sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
                            fieldLabel="Title"
                            name="./title"/>
                        <text
                            jcr:primaryType="nt:unstructured"
                            sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
                            fieldLabel="Text"
                            name="./text"/>
                    </items>
                </column>
            </items>
        </content>
    </jcr:root>
    
  7. 아래 경로에서 HelloWorld 구성 요소를 렌더링하는 기본 HTL 스크립트를 나타내는 helloworld.html 파일을 다시 엽니다.

    code language-plain
        <code>/aem-guides-wknd.ui.apps/src/main/content/jcr_root/apps/wknd/components/helloworld/helloworld.html
    
  8. helloworld.html을(를) 업데이트하여 Greeting 텍스트 필드의 값을 H1 태그의 일부로 렌더링합니다.

    code language-html
    <div class="cmp-helloworld" data-cmp-is="helloworld">
        <h1 class="cmp-helloworld__title">${properties.title}</h1>
        ...
    </div>
    
  9. 개발자 플러그인을 사용하거나 Maven 기술을 사용하여 AEM의 로컬 인스턴스에 변경 사항을 배포합니다.

Sling 모델 sling-models

Sling 모델은 JCR에서 Java™ 변수로 데이터를 쉽게 매핑하는 주석 기반 Java™ "POJO"(일반 이전 Java™ 개체)입니다. 또한 AEM의 컨텍스트에서 개발할 때 몇 가지 다른 좋은 점을 제공합니다.

다음으로 HelloWorldModel Sling 모델을 업데이트하여 JCR에 저장된 값에 비즈니스 논리를 적용한 후 페이지에 출력해 보겠습니다.

  1. HelloWorld 구성 요소와 함께 사용되는 슬링 모델인 HelloWorldModel.java 파일을 엽니다.

    code language-plain
    <code>/aem-guides-wknd.core/src/main/java/com/adobe/aem/guides/wknd/core/models/HelloWorldModel.java
    
  2. 다음 가져오기 구문을 추가합니다.

    code language-java
    import org.apache.commons.lang3.StringUtils;
    import org.apache.sling.models.annotations.DefaultInjectionStrategy;
    
  3. DefaultInjectionStrategy을(를) 사용하도록 @Model 주석을 업데이트합니다.

    code language-java
    @Model(adaptables = Resource.class,
       defaultInjectionStrategy = DefaultInjectionStrategy.OPTIONAL)
       public class HelloWorldModel {
       ...
    
  4. 구성 요소의 JCR 속성 titletext을(를) Java™ 변수에 매핑하려면 HelloWorldModel 클래스에 다음 줄을 추가하십시오.

    code language-java
    ...
    @Model(adaptables = Resource.class,
    defaultInjectionStrategy = DefaultInjectionStrategy.OPTIONAL)
    public class HelloWorldModel {
    
        ...
    
        @ValueMapValue
        private String title;
    
        @ValueMapValue
        private String text;
    
        @PostConstruct
        protected void init() {
            ...
    
  5. 이름이 title인 속성의 값을 반환하는 HelloWorldModel 클래스에 다음 메서드 getTitle()을(를) 추가합니다. 이 메서드는 추가 논리를 추가하여 "Default Value here!"라는 문자열 값을 반환합니다. title 속성이 null이거나 비어 있는 경우:

    code language-java
    /***
    *
    * @return the value of title, if null or blank returns "Default Value here!"
    */
    public String getTitle() {
        return StringUtils.isNotBlank(title) ? title : "Default Value here!";
    }
    
  6. 이름이 text인 속성의 값을 반환하는 HelloWorldModel 클래스에 다음 메서드 getText()을(를) 추가합니다. 이 메서드는 String을 모든 대문자로 변환합니다.

    code language-java
        /***
        *
        * @return All caps variation of the text value
        */
    public String getText() {
        return StringUtils.isNotBlank(this.text) ? this.text.toUpperCase() : null;
    }
    
  7. core 모듈에서 번들을 빌드하고 배포합니다.

    code language-shell
    $ cd core
    $ mvn clean install -PautoInstallBundle
    
    note note
    NOTE
    AEM 6.4/6.5의 경우 mvn clean install -PautoInstallBundle -Pclassic 사용
  8. HelloWorld 모델의 새로 만든 메서드를 사용하려면 aem-guides-wknd.ui.apps/src/main/content/jcr_root/apps/wknd/components/content/helloworld/helloworld.html에서 helloworld.html 파일을 업데이트하십시오.

    HTL 지시문 data-sly-use.model="com.adobe.aem.guides.wknd.core.models.HelloWorldModel"을(를) 통해 이 구성 요소 인스턴스에 대해 HelloWorld 모델이 인스턴스화되어 인스턴스를 model 변수에 저장합니다.

    이제 HelloWord을(를) 사용하여 model 변수를 통해 HTL에서 HelloWorld 모델 인스턴스를 사용할 수 있습니다. 이러한 메서드 호출에서는 단축된 메서드 구문을 사용할 수 있습니다. 예를 들어 ${model.getTitle()}은(는) ${model.title}에 단락될 수 있습니다.

    마찬가지로 모든 HTL 스크립트에는 Sling 모델 개체와 동일한 구문을 사용하여 액세스할 수 있는 전역 개체가 삽입됩니다.

    code language-html
    <div class="cmp-helloworld" data-cmp-is="helloworld"
        data-sly-use.model="com.adobe.aem.guides.wknd.core.models.HelloWorldModel">
        <h1 class="cmp-helloworld__title">${model.title}</h1>
        <div class="cmp-helloworld__item" data-sly-test="${properties.text}">
            <p class="cmp-helloworld__item-label">Text property:</p>
            <pre class="cmp-helloworld__item-output" data-cmp-hook-helloworld="property">${properties.text}</pre>
        </div>
        <div class="cmp-helloworld__item" data-sly-test="${model.text}">
            <p class="cmp-helloworld__item-label">Sling Model getText() property:</p>
            <pre class="cmp-helloworld__item-output" data-cmp-hook-helloworld="property">${model.text}</pre>
        </div>
    </div>
    
  9. Eclipse Developer 플러그인을 사용하거나 Maven 기술을 사용하여 변경 사항을 AEM의 로컬 인스턴스에 배포합니다.

클라이언트측 라이브러리 client-side-libraries

클라이언트측 라이브러리 clientlibs은(는) AEM Sites 구현에 필요한 CSS 및 JavaScript 파일을 구성하고 관리하는 메커니즘을 제공합니다. 클라이언트측 라이브러리는 AEM의 페이지에 CSS 및 JavaScript을 포함하는 표준 방법입니다.

ui.frontend 모듈은 빌드 프로세스에 통합되는 연결 해제된 webpack 프로젝트입니다. 이를 통해 Sass, LESS 및 TypeScript와 같이 인기 있는 프론트엔드 라이브러리를 사용할 수 있습니다. ui.frontend 모듈은 클라이언트측 라이브러리 챕터에서 자세히 살펴봅니다.

그런 다음 HelloWorld 구성 요소의 CSS 스타일을 업데이트합니다.

다음은 위 비디오에서 수행되는 높은 수준의 단계입니다.

  1. 터미널 창을 열고 ui.frontend 디렉터리로 이동합니다.

  2. ui.frontend 디렉터리에 있는 동안 npm install npm-run-all --save-dev 명령을 실행하여 npm-run-all 노드 모듈을 설치합니다. 이 단계는 Archetype 39에서 생성된 AEM 프로젝트에 필요합니다. 향후 Archetype 버전에서는 필요하지 않습니다.

  3. 그런 다음 npm run watch 명령을 실행합니다.

    code language-shell
    $ npm run watch
    
  4. IDE로 전환하고 프로젝트를 ui.frontend 모듈로 엽니다.

  5. ui.frontend/src/main/webpack/components/_helloworld.scss 파일을 엽니다.

  6. 파일을 업데이트하여 빨간색 제목을 표시합니다.

    code language-scss
    .cmp-helloworld {}
    .cmp-helloworld__title {
        color: red;
    }
    
  7. 터미널에 ui.frontend 모듈이 컴파일되고 변경 내용을 AEM의 로컬 인스턴스와 동기화하고 있음을 나타내는 활동이 표시됩니다.

    code language-shell
    Entrypoint site 214 KiB = clientlib-site/site.css 8.45 KiB clientlib-site/site.js 206 KiB
    2022-02-22 17:28:51: webpack 5.69.1 compiled successfully in 119 ms
    change:dist/index.html
    + jcr_root/apps/wknd/clientlibs/clientlib-site/css/site.css
    + jcr_root/apps/wknd/clientlibs/clientlib-site/css
    + jcr_root/apps/wknd/clientlibs/clientlib-site/js/site.js
    + jcr_root/apps/wknd/clientlibs/clientlib-site/js
    + jcr_root/apps/wknd/clientlibs/clientlib-site
    + jcr_root/apps/wknd/clientlibs/clientlib-dependencies/css.txt
    + jcr_root/apps/wknd/clientlibs/clientlib-dependencies/js.txt
    + jcr_root/apps/wknd/clientlibs/clientlib-dependencies
    
  8. 브라우저로 돌아가서 제목 색상이 변경되었는지 확인합니다.

    구성 요소 기본 사항 업데이트

축하합니다! congratulations

축하합니다. Adobe Experience Manager에서 구성 요소 개발에 대한 기본 사항을 배웠습니다!

다음 단계 next-steps

다음 장 페이지 및 템플릿에서 Adobe Experience Manager 페이지 및 템플릿에 익숙해지십시오. 핵심 구성 요소가 프로젝트로 프록시되는 방법을 이해하고 편집 가능한 템플릿의 고급 정책 구성을 학습하여 잘 구성된 문서 페이지 템플릿을 구축할 수 있습니다.

GitHub에서 완료된 코드를 보거나 Git 분기 tutorial/component-basics-solution에서 로컬로 코드를 검토하고 배포합니다.

recommendation-more-help
b2a561c1-47c0-4182-b8c1-757a197484f9