사용자 정의 구성 요소 custom-component

이 자습서에서는 대화 상자에서 작성된 콘텐츠를 표시하는 사용자 지정 Byline AEM 구성 요소를 완전히 만들고 구성 요소의 HTL을 채우는 비즈니스 논리를 캡슐화하는 슬링 모델 개발을 살펴봅니다.

사전 요구 사항 prerequisites

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

스타터 프로젝트

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

자습서가 빌드하는 기본 코드 체크 아웃:

  1. GitHub에서 tutorial/custom-component-start 분기 확인

    code language-shell
    $ cd aem-guides-wknd
    $ git checkout tutorial/custom-component-start
    
  2. Maven 기술을 사용하여 로컬 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
    

GitHub에서 완성된 코드를 항상 보거나 tutorial/custom-component-solution 분기로 전환하여 코드를 로컬로 확인할 수 있습니다.

목표

  1. 사용자 지정 AEM 구성 요소를 빌드하는 방법 이해
  2. 비즈니스 논리를 Sling 모델로 캡슐화하는 방법에 대해 알아보기
  3. HTL 스크립트 내에서 Sling 모델을 사용하는 방법을 이해합니다

빌드할 항목 what-build

WKND 튜토리얼의 이 부분에서는 문서 기여자에 대한 작성된 정보를 표시하는 데 사용되는 인라인 구성 요소가 만들어집니다.

byline 구성 요소 예제

줄 구성 요소

Byline 구성 요소의 구현에는 byline 콘텐츠를 수집하는 대화 상자와 다음과 같은 세부 정보를 검색하는 사용자 지정 Sling 모델이 포함되어 있습니다.

  • 이름
  • 이미지
  • 직업

Byline 구성 요소 만들기 create-byline-component

먼저 Byline Component 노드 구조를 만들고 대화 상자를 정의합니다. AEM의 구성 요소를 나타내고 JCR에서의 해당 위치로 구성 요소의 리소스 유형을 암시적으로 정의합니다.

대화 상자는 콘텐츠 작성자가 제공할 수 있는 인터페이스를 표시합니다. 이 구현의 경우 AEM WCM 핵심 구성 요소의 Image 구성 요소는 Byline의 이미지 작성 및 렌더링을 처리하는 데 사용되므로 이 구성 요소의 sling:resourceSuperType(으)로 설정해야 합니다.

구성 요소 정의 만들기 create-component-definition

  1. ui.apps 모듈에서 /apps/wknd/components(으)로 이동하여 byline 폴더를 만듭니다.

  2. byline 폴더 안에 .content.xml 파일을 추가합니다.

    노드를 만드는 대화 상자

  3. .content.xml 파일을 다음과 같이 채웁니다.

    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"
        jcr:primaryType="cq:Component"
        jcr:title="Byline"
        jcr:description="Displays a contributor's byline."
        componentGroup="WKND Sites Project - Content"
        sling:resourceSuperType="core/wcm/components/image/v2/image"/>
    

    위의 XML 파일은 제목, 설명 및 그룹을 포함하여 구성 요소에 대한 정의를 제공합니다. sling:resourceSuperType이(가) 핵심 이미지 구성 요소core/wcm/components/image/v2/image을(를) 가리킵니다.

HTL 스크립트 만들기 create-the-htl-script

  1. byline 폴더 안에 구성 요소의 HTML 프레젠테이션을 담당하는 byline.html 파일을 추가하십시오. Sling이 이 리소스 유형을 렌더링하는 데 사용하는 기본 스크립트가 되므로 파일과 동일한 파일의 이름을 지정하는 것이 중요합니다.

  2. byline.html에 다음 코드를 추가하십시오.

    code language-html
    <!--/* byline.html */-->
    <div data-sly-use.placeholderTemplate="core/wcm/components/commons/v1/templates.html">
    </div>
    <sly data-sly-call="${placeholderTemplate.placeholder @ isEmpty=true}"></sly>
    

슬링 모델이 만들어지면 byline.html이(가) 나중에 다시 방문됨입니다. HTL 파일의 현재 상태를 사용하면 구성 요소를 드래그하여 페이지에 놓을 때 AEM Sites의 페이지 편집기에서 빈 상태로 표시할 수 있습니다.

대화 상자 정의 만들기 create-the-dialog-definition

다음으로, 다음 필드가 있는 Byline 구성 요소의 대화 상자를 정의합니다.

  • 이름: 기여자의 이름을 나타내는 텍스트 필드입니다.
  • 이미지: 기여자의 생체 사진 참조.
  • 작업: 기여자의 작업 목록입니다. 직업은 알파벳순으로 오름차순(a에서 z까지)으로 정렬해야 합니다.
  1. byline 폴더 안에 _cq_dialog 폴더를 만듭니다.

  2. byline/_cq_dialog 내에서 이름이 .content.xml인 파일을 추가하십시오. 대화 상자에 대한 XML 정의입니다. 다음 XML을 추가합니다.

    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="Byline"
            sling:resourceType="cq/gui/components/authoring/dialog">
        <content
                jcr:primaryType="nt:unstructured"
                sling:resourceType="granite/ui/components/coral/foundation/container">
            <items jcr:primaryType="nt:unstructured">
                <tabs
                        jcr:primaryType="nt:unstructured"
                        sling:resourceType="granite/ui/components/coral/foundation/tabs"
                        maximized="{Boolean}false">
                    <items jcr:primaryType="nt:unstructured">
                        <asset
                                jcr:primaryType="nt:unstructured"
                                sling:hideResource="{Boolean}false"/>
                        <metadata
                                jcr:primaryType="nt:unstructured"
                                sling:hideResource="{Boolean}true"/>
                        <properties
                                jcr:primaryType="nt:unstructured"
                                jcr:title="Properties"
                                sling:resourceType="granite/ui/components/coral/foundation/container"
                                margin="{Boolean}true">
                            <items jcr:primaryType="nt:unstructured">
                                <columns
                                        jcr:primaryType="nt:unstructured"
                                        sling:resourceType="granite/ui/components/coral/foundation/fixedcolumns"
                                        margin="{Boolean}true">
                                    <items jcr:primaryType="nt:unstructured">
                                        <column
                                                jcr:primaryType="nt:unstructured"
                                                sling:resourceType="granite/ui/components/coral/foundation/container">
                                            <items jcr:primaryType="nt:unstructured">
                                                <name
                                                        jcr:primaryType="nt:unstructured"
                                                        sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
                                                        emptyText="Enter the contributor's name to display."
                                                        fieldDescription="The contributor's name to display."
                                                        fieldLabel="Name"
                                                        name="./name"
                                                        required="{Boolean}true"/>
                                                <occupations
                                                        jcr:primaryType="nt:unstructured"
                                                        sling:resourceType="granite/ui/components/coral/foundation/form/multifield"
                                                        fieldDescription="A list of the contributor's occupations."
                                                        fieldLabel="Occupations"
                                                        required="{Boolean}false">
                                                    <field
                                                            jcr:primaryType="nt:unstructured"
                                                            sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
                                                            emptyText="Enter an occupation"
                                                            name="./occupations"/>
                                                </occupations>
                                            </items>
                                        </column>
                                    </items>
                                </columns>
                            </items>
                        </properties>
                    </items>
                </tabs>
            </items>
        </content>
    </jcr:root>
    

    이러한 대화 상자 노드 정의는 Sling 리소스 병합을 사용하여 sling:resourceSuperType 구성 요소에서 상속되는 대화 상자 탭을 제어합니다. 이 경우 핵심 구성 요소의 이미지 구성 요소 ​가 상속됩니다.

    줄 에 대한 대화 상자 완료

정책 대화 상자 만들기 create-the-policy-dialog

대화 상자 만들기와 동일한 방법에 따라 핵심 구성 요소의 이미지 구성 요소에서 상속된 정책 구성에서 원하지 않는 필드를 숨기기 위한 정책 대화 상자(이전의 디자인 대화 상자)를 만듭니다.

  1. byline 폴더 안에 _cq_design_dialog 폴더를 만듭니다.

  2. byline/_cq_design_dialog 내에서 이름이 .content.xml인 파일을 만듭니다. 다음 XML을 사용하여 파일을 다음과 같이 업데이트합니다. .content.xml을(를) 열고 아래의 XML을 복사하거나 붙여 넣는 것이 가장 쉽습니다.

    code language-xml
    <?xml version="1.0" encoding="UTF-8"?>
    <jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:granite="http://www.adobe.com/jcr/granite/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="Byline"
        sling:resourceType="cq/gui/components/authoring/dialog">
        <content
                jcr:primaryType="nt:unstructured">
            <items jcr:primaryType="nt:unstructured">
                <tabs
                        jcr:primaryType="nt:unstructured">
                    <items jcr:primaryType="nt:unstructured">
                        <properties
                                jcr:primaryType="nt:unstructured">
                            <items jcr:primaryType="nt:unstructured">
                                <content
                                        jcr:primaryType="nt:unstructured">
                                    <items jcr:primaryType="nt:unstructured">
                                        <decorative
                                                jcr:primaryType="nt:unstructured"
                                                sling:hideResource="{Boolean}true"/>
                                        <altValueFromDAM
                                                jcr:primaryType="nt:unstructured"
                                                sling:hideResource="{Boolean}true"/>
                                        <titleValueFromDAM
                                                jcr:primaryType="nt:unstructured"
                                                sling:hideResource="{Boolean}true"/>
                                        <displayCaptionPopup
                                                jcr:primaryType="nt:unstructured"
                                                sling:hideResource="{Boolean}true"/>
                                        <disableUuidTracking
                                                jcr:primaryType="nt:unstructured"
                                                sling:hideResource="{Boolean}true"/>
                                    </items>
                                </content>
                            </items>
                        </properties>
                        <features
                                jcr:primaryType="nt:unstructured">
                            <items jcr:primaryType="nt:unstructured">
                                <content
                                        jcr:primaryType="nt:unstructured">
                                    <items jcr:primaryType="nt:unstructured">
                                        <accordion
                                                jcr:primaryType="nt:unstructured">
                                            <items jcr:primaryType="nt:unstructured">
                                                <orientation
                                                        jcr:primaryType="nt:unstructured"
                                                        sling:hideResource="{Boolean}true"/>
                                                <crop
                                                        jcr:primaryType="nt:unstructured"
                                                        sling:hideResource="{Boolean}true"/>
                                            </items>
                                        </accordion>
                                    </items>
                                </content>
                            </items>
                        </features>
                    </items>
                </tabs>
            </items>
        </content>
    </jcr:root>
    

    이전 정책 대화 상자 XML의 기초는 핵심 구성 요소 이미지 구성 요소에서 가져왔습니다.

    대화 상자 구성과 마찬가지로 Sling 리소스 병합은(는) sling:hideResource="{Boolean}true" 속성의 노드 정의에서 볼 수 있듯이 sling:resourceSuperType에서 상속된 관련 없는 필드를 숨기는 데 사용됩니다.

코드 배포 deploy-the-code

  1. ui.apps의 변경 내용을 IDE와 동기화하거나 Maven 기술을 사용합니다.

    AEM 서버 byline 구성 요소로 내보내기

페이지에 구성 요소 추가 add-the-component-to-a-page

AEM 구성 요소 개발에 초점을 맞추고 단순하게 유지하기 위해 현재 상태의 Byline 구성 요소를 Article 페이지에 추가하여 cq:Component 노드 정의가 올바른지 확인하겠습니다. 또한 AEM에서 새 구성 요소 정의를 인식하고 구성 요소의 대화 상자가 작성에 작동하는지 확인합니다.

AEM Assets에 이미지 추가

먼저 샘플 헤드 샷을 AEM Assets에 업로드하여 를 사용하여 Byline 구성 요소에서 이미지를 채웁니다.

  1. AEM Assets의 LA Skateparks 폴더로 이동합니다. http://localhost:4502/assets.html/content/dam/wknd/en/magazine/la-skateparks.

  2. stacey-roflowers.jpg ​에 대한 헤드 샷을 폴더에 업로드합니다.

    Headshot이 AEM Assets에 업로드됨

구성 요소 작성 author-the-component

그런 다음 AEM의 페이지에 Byline 구성 요소를 추가합니다. Byline 구성 요소는 ui.apps/src/main/content/jcr_root/apps/wknd/components/byline/.content.xml 정의를 통해 WKND Sites 프로젝트 - Content 구성 요소 그룹에 추가되므로 정책 ​에서 WKND Sites 프로젝트 - Content 구성 요소 그룹을 허용하는 Container ​에 자동으로 사용할 수 있습니다. 따라서 문서 페이지의 레이아웃 컨테이너에서 사용할 수 있습니다.

  1. LA Skatepark 문서(http://localhost:4502/editor.html/content/wknd/us/en/magazine/guide-la-skateparks.html)로 이동합니다.

  2. 왼쪽 사이드바에서 Byline 구성 요소 ​를 열린 문서 페이지의 레이아웃 컨테이너 아래쪽(으)로 끌어서 놓습니다.

    페이지에 byline 구성 요소 추가

  3. 왼쪽 사이드바가 열려 있고​ 볼 수 있으며 ​자산 파인더**가 선택되어 있는지 확인하십시오.

  4. 줄 구성 요소 자리 표시자 ​를 선택하면 작업 표시줄이 표시되고 렌치 아이콘을 탭하여 대화 상자가 열립니다.

  5. 대화 상자를 열고 첫 번째 탭(에셋)이 활성화된 상태에서 왼쪽 사이드바를 열고 에셋 파인더에서 이미지를 이미지 드롭 영역으로 드래그합니다. WKND ui.content 패키지에서 제공되는 Stacey Roflowers 바이오 사진을 찾기 위해 "스테이시"를 검색하세요.

    대화 상자에 이미지 추가

  6. 이미지를 추가한 후 속성 탭을 클릭하여 이름직업 ​을(를) 입력하십시오.

    직업을 입력할 때 알파벳 역순 순서로 입력하면 Sling 모델에서 구현된 알파벳순 비즈니스 논리를 확인합니다.

    변경 내용을 저장하려면 오른쪽 하단에 있는 완료 단추를 탭하세요.

    byline 구성 요소의 속성 채우기

    AEM 작성자는 대화 상자를 통해 구성 요소를 구성하고 작성합니다. 이 시점에서 Byline 구성 요소 개발 시 데이터 수집을 위한 대화 상자가 포함되지만 작성된 콘텐츠를 렌더링하는 논리는 아직 추가되지 않았습니다. 따라서 자리 표시자만 표시됩니다.

  7. 대화 상자를 저장한 후 CRXDE Lite(으)로 이동하여 구성 요소의 콘텐츠가 AEM 페이지 아래의 byline 구성 요소 콘텐츠 노드에 어떻게 저장되는지 검토하십시오.

    LA Skate Parks 페이지 아래에서 Byline 구성 요소 콘텐츠 노드(예: /content/wknd/us/en/magazine/guide-la-skateparks/jcr:content/root/container/container/byline)를 찾습니다.

    속성 이름 name, occupationsfileReference이(가) byline 노드 ​에 저장되어 있습니다.

    또한 노드의 sling:resourceType이(가) Byline 구성 요소 구현에 이 콘텐츠 노드를 바인딩하는 wknd/components/content/byline(으)로 설정되어 있습니다.

    CRXDE의 byline 속성

Byline Sling 모델 만들기 create-sling-model

다음으로 데이터 모델로 작동하는 슬링 모델을 만들어 Byline 구성 요소에 대한 비즈니스 논리를 포함하겠습니다.

Sling 모델은 JCR에서 Java™ 변수로의 데이터 매핑을 촉진하고 AEM 컨텍스트에서 개발 시 효율성을 제공하는 주석 기반 Java™ POJO(일반 이전 Java™ 개체)입니다.

Maven 종속성 검토 maven-dependency

Byline Sling 모델은 AEM에서 제공하는 여러 Java™ API를 사용합니다. 이러한 API는 core 모듈의 POM 파일에 나열된 dependencies을(를) 통해 사용할 수 있습니다. 이 자습서에 사용된 프로젝트는 AEM as a Cloud Service용으로 빌드되었습니다. 그러나 AEM 6.5/6.4와 이전 버전과 호환되므로 독특합니다. 따라서 Cloud Service과 AEM 6.x에 대한 종속성이 모두 포함됩니다.

  1. <src>/aem-guides-wknd/core/pom.xml 아래에서 pom.xml 파일을 엽니다.

  2. aem-sdk-api - AEM as a Cloud Service 전용 ​에 대한 종속성을 찾습니다.

    code language-xml
    <dependency>
        <groupId>com.adobe.aem</groupId>
        <artifactId>aem-sdk-api</artifactId>
    </dependency>
    

    aem-sdk-api에는 AEM에서 공개한 모든 공개 Java™ API가 포함되어 있습니다. 이 프로젝트를 빌드할 때 기본적으로 aem-sdk-api이(가) 사용됩니다. 버전은 aem-guides-wknd/pom.xml에 있는 프로젝트의 루트에서 상위 반응기 pom에 유지됩니다.

  3. uber-jar에 대한 종속성 찾기 - AEM 6.5/6.4 전용

    code language-xml
    ...
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>uber-jar</artifactId>
            <classifier>apis</classifier>
        </dependency>
    ...
    

    uber-jar은(는) classic 프로필을 호출할 때만 포함됩니다(예: mvn clean install -PautoInstallSinglePackage -Pclassic). 이는 이 프로젝트에 고유합니다. AEM Project Archetype에서 생성된 실제 프로젝트에서는 지정된 AEM 버전이 6.5 또는 6.4인 경우 uber-jar이(가) 기본값입니다.

    uber-jar에는 AEM 6.x에서 노출된 모든 공개 Java™ API가 포함되어 있습니다. 버전은 프로젝트 aem-guides-wknd/pom.xml의 루트에서 상위 반응기 pom에 유지됩니다.

  4. core.wcm.components.core에 대한 종속성을 찾습니다.

    code language-xml
     <!-- Core Component Dependency -->
        <dependency>
            <groupId>com.adobe.cq</groupId>
            <artifactId>core.wcm.components.core</artifactId>
        </dependency>
    

    AEM 핵심 구성 요소에 의해 노출된 전체 공개 Java™ API입니다. AEM 핵심 구성 요소는 AEM 외부에서 유지 관리되는 프로젝트이므로 릴리스 주기가 별도로 있습니다. 따라서 이 종속성은 별도로 포함되어야 하며 uber-jar 또는 aem-sdk-api에 포함된 not ​입니다.

    uber-jar와 마찬가지로 이 종속성에 대한 버전은 aem-guides-wknd/pom.xml의 상위 리액터 pom 파일에서 유지됩니다.

    이 자습서의 뒷부분에서 핵심 구성 요소의 이미지 클래스를 사용하여 바이라인 구성 요소에 이미지를 표시할 수 있습니다. 슬링 모델을 빌드하고 컴파일하려면 핵심 구성 요소 종속성이 있어야 합니다.

Byline 인터페이스 byline-interface

바이라인에 대한 공개 Java™ 인터페이스를 만듭니다. Byline.java은(는) byline.html HTL 스크립트를 실행하는 데 필요한 공용 메서드를 정의합니다.

  1. core/src/main/java/com/adobe/aem/guides/wknd/core/models 폴더의 core 모듈에서 Byline.java 파일을 만듭니다.

    바이라인 인터페이스 만들기

  2. 다음 메서드로 Byline.java을(를) 업데이트합니다.

    code language-java
    package com.adobe.aem.guides.wknd.core.models;
    
    import java.util.List;
    
    /**
    * Represents the Byline AEM Component for the WKND Site project.
    **/
    public interface Byline {
        /***
        * @return a string to display as the name.
        */
        String getName();
    
        /***
        * Occupations are to be sorted alphabetically in a descending order.
        *
        * @return a list of occupations.
        */
        List<String> getOccupations();
    
        /***
        * @return a boolean if the component has enough content to display.
        */
        boolean isEmpty();
    }
    

    처음 두 메서드는 Byline 구성 요소의 nameoccuptions 값을 표시합니다.

    isEmpty() 메서드는 구성 요소에 렌더링할 콘텐츠가 있는지 또는 구성 대기 중인지 확인하는 데 사용됩니다.

    이미지에 대한 메서드가 없습니다. 나중에 검토함.

  3. 공개 Java™ 클래스가 포함된 Java™ 패키지(이 경우 Sling 모델)는 패키지의 package-info.java 파일을 사용하여 버전을 지정해야 합니다.

    WKND 원본의 Java™ 패키지 com.adobe.aem.guides.wknd.core.models이(가) 1.0.0 버전을 선언하고 있으며 끊기지 않는 공용 인터페이스와 메서드를 추가하고 있으므로 버전을 1.1.0(으)로 늘려야 합니다. core/src/main/java/com/adobe/aem/guides/wknd/core/models/package-info.java에서 파일을 열고 @Version("1.0.0")을(를) @Version("2.1.0")(으)로 업데이트합니다.

    code language-none
    @Version("2.1.0")
    package com.adobe.aem.guides.wknd.core.models;
    
    import org.osgi.annotation.versioning.Version;
    

이 패키지의 파일을 변경할 때마다 패키지 버전을 의미상으로 조정해야 합니다. 그렇지 않으면 Maven 프로젝트의 bnd-baseline-maven-plugin이(가) 잘못된 패키지 버전을 감지하고 빌드된 버전을 중단합니다. 다행히도 실패 시 Maven 플러그인은 잘못된 Java™ 패키지 버전 및 그 버전을 보고합니다. Java™ 패키지 package-info.java을(를) 위반하는 @Version("...") 선언을 플러그 인에서 권장하는 버전으로 업데이트하여 수정하십시오.

Byline 구현 byline-implementation

BylineImpl.java은(는) 이전에 정의된 Byline.java 인터페이스를 구현하는 슬링 모델의 구현입니다. BylineImpl.java에 대한 전체 코드는 이 섹션의 맨 아래에 있습니다.

  1. core/src/main/java/com/adobe/aem/guides/core/models 아래에 이름이 impl인 폴더를 만듭니다.

  2. impl 폴더에서 BylineImpl.java 파일을 만듭니다.

    Byline Impl 파일

  3. BylineImpl.java 열기 Byline 인터페이스를 구현하도록 지정하십시오. IDE의 자동 완성 기능을 사용하거나 Byline 인터페이스를 구현하는 데 필요한 메서드를 포함하도록 파일을 수동으로 업데이트하십시오.

    code language-java
    package com.adobe.aem.guides.wknd.core.models.impl;
    import java.util.List;
    import com.adobe.aem.guides.wknd.core.models.Byline;
    
    public class BylineImpl implements Byline {
    
        @Override
        public String getName() {
            // TODO Auto-generated method stub
            return null;
        }
    
        @Override
        public List<String> getOccupations() {
            // TODO Auto-generated method stub
            return null;
        }
    
        @Override
        public boolean isEmpty() {
            // TODO Auto-generated method stub
            return false;
        }
    }
    
  4. BylineImpl.java을(를) 다음 클래스 수준 주석으로 업데이트하여 슬링 모델 주석을 추가하십시오. 이 @Model(..)주석은 클래스를 Sling 모델로 바꿉니다.

    code language-java
    import org.apache.sling.api.SlingHttpServletRequest;
    import org.apache.sling.models.annotations.Model;
    import org.apache.sling.models.annotations.DefaultInjectionStrategy;
    ...
    @Model(
            adaptables = {SlingHttpServletRequest.class},
            adapters = {Byline.class},
            resourceType = {BylineImpl.RESOURCE_TYPE},
            defaultInjectionStrategy = DefaultInjectionStrategy.OPTIONAL
    )
    public class BylineImpl implements Byline {
        protected static final String RESOURCE_TYPE = "wknd/components/byline";
        ...
    }
    

    이 주석과 해당 매개 변수를 검토해 보겠습니다.

    • @Model 주석이 AEM에 배포될 때 BylineImpl이 Sling 모델로 등록됩니다.
    • adaptables 매개 변수는 이 모델을 요청으로 조정할 수 있도록 지정합니다.
    • adapters 매개 변수를 사용하면 구현 클래스를 Byline 인터페이스에 등록할 수 있습니다. 이를 통해 HTL 스크립트는 인터페이스를 통해(직접 구현하지 않고) 슬링 모델을 호출할 수 있습니다. 어댑터에 대한 자세한 내용은 여기를 참조하십시오.
    • resourceType은(는) Byline 구성 요소 리소스 유형(이전에 만든)을 가리키며, 구현이 여러 개인 경우 올바른 모델을 해결하는 데 도움이 됩니다. 모델 클래스를 리소스 형식과 연결하는 방법에 대한 자세한 내용은에서 확인할 수 있습니다.

Sling 모델 메서드 구현 implementing-the-sling-model-methods

getName() implementing-get-name

구현된 첫 번째 메서드는 getName()이며, 속성 name 아래에 있는 byline의 JCR 콘텐츠 노드에 저장된 값을 반환하기만 하면 됩니다.

이를 위해 @ValueMapValue Sling 모델 주석을 사용하여 요청 리소스의 ValueMap을 사용하여 Java™ 필드에 값을 삽입합니다.

import org.apache.sling.models.annotations.injectorspecific.ValueMapValue;

public class BylineImpl implements Byline {
    ...
    @ValueMapValue
    private String name;

    ...
    @Override
    public String getName() {
        return name;
    }
    ...
}

JCR 속성은 이름을 Java™ 필드로 공유하므로(둘 다 "name") @ValueMapValue은(는) 자동으로 이 연결을 확인하고 속성 값을 Java™ 필드에 삽입합니다.

getOccuptions() implementing-get-occupations

구현할 다음 메서드는 getOccupations()입니다. 이 메서드는 JCR 속성 occupations에 저장된 작업을 로드하고 정렬된(알파벳순으로) 컬렉션을 반환합니다.

getName()에서 설명한 것과 동일한 기술을 사용하여 속성 값을 Sling 모델의 필드에 삽입할 수 있습니다.

주입된 Java™ 필드 occupations을(를) 통해 Sling 모델에서 JCR 속성 값을 사용할 수 있게 되면 getOccupations() 메서드에서 정렬 비즈니스 논리를 적용할 수 있습니다.

import java.util.ArrayList;
import java.util.Collections;
  ...

public class BylineImpl implements Byline {
    ...
    @ValueMapValue
    private List<String> occupations;
    ...
    @Override
    public List<String> getOccupations() {
        if (occupations != null) {
            Collections.sort(occupations);
            return new ArrayList<String>(occupations);
        } else {
            return Collections.emptyList();
        }
    }
    ...
}
  ...

isEmpty() implementing-is-empty

마지막 공개 메서드는 구성 요소가 렌더링할 자신을 "충분히 작성됨"으로 간주해야 하는 시기를 결정하는 isEmpty()입니다.

이 구성 요소의 경우 비즈니스 요구 사항은 모두 세 필드입니다. 구성 요소를 렌더링하기 전에 name, image and occupations을(를) 먼저 ​해야 합니다.

import org.apache.commons.lang3.StringUtils;
  ...
public class BylineImpl implements Byline {
    ...
    @Override
    public boolean isEmpty() {
        if (StringUtils.isBlank(name)) {
            // Name is missing, but required
            return true;
        } else if (occupations == null || occupations.isEmpty()) {
            // At least one occupation is required
            return true;
        } else if (/* image is not null, logic to be determined */) {
            // A valid image is required
            return true;
        } else {
            // Everything is populated, so this component is not considered empty
            return false;
        }
    }
    ...
}

"이미지 문제" 해결 tackling-the-image-problem

이름과 직업 조건을 확인하는 것은 사소한 일이며 Apache Commons Lang3은 유용한 StringUtils 클래스를 제공합니다. 그러나 핵심 구성 요소 이미지 구성 요소를 사용하여 이미지를 표시하기 때문에 이미지 존재 ​의 유효성을 검사하는 방법은 확실하지 않습니다.

이 문제를 해결하는 방법에는 두 가지가 있습니다.

fileReference JCR 속성이 자산으로 확인되는지 확인하십시오. OR 이 리소스를 핵심 구성 요소 이미지 Sling 모델로 변환하고 getSrc() 메서드가 비어 있지 않은지 확인하십시오.

방법을 사용하겠습니다. 첫 번째 접근 방법으로도 충분하지만, 이 자습서에서는 후자를 사용하여 슬링 모델의 다른 기능을 탐색할 수 있습니다.

  1. 이미지를 가져오는 개인 메서드를 만듭니다. 이 메서드는 HTL 자체에서 Image 개체를 노출할 필요가 없으며 isEmpty().을(를) 구동하는 데만 사용되므로 비공개로 유지됩니다

    getImage()에 대해 다음 전용 메서드를 추가합니다.

    code language-java
    import com.adobe.cq.wcm.core.components.models.Image;
    ...
    private Image getImage() {
        Image image = null;
        // Figure out how to populate the image variable!
        return image;
    }
    

    위에서 설명한 대로 이미지 Sling 모델 ​을 가져오는 두 가지 방법이 더 있습니다.

    먼저 @Self 주석을 사용하여 현재 요청을 핵심 구성 요소의 Image.class(으)로 자동 조정합니다

    두 번째는 편리한 서비스인 Apache Sling ModelFactory OSGi 서비스를 사용하며 Java™ 코드에서 다른 유형의 Sling 모델을 만드는 데 도움이 됩니다.

    두 번째 방법을 사용하겠습니다.

    note note
    NOTE
    실제 구현에서는 보다 간단하고 우아한 솔루션이므로 @Self을(를) 사용하여 "One"에 접근하는 것이 좋습니다. 이 자습서에서는 두 번째 접근 방식을 사용합니다. 두 번째 접근 방식은 보다 복잡한 구성 요소로서 유용한 Sling 모델의 더 많은 측면을 탐색해야 하기 때문입니다.

    슬링 모델은 OSGi 서비스가 아닌 Java™ POJO이므로 일반적인 OSGi 주입 주석 @Reference 사용할 수 없음 ​을 사용합니다. 대신 슬링 모델은 유사한 기능을 제공하는 특별한 @OSGiService 주석을 제공합니다.

  2. ModelFactory을(를) 삽입할 OSGiService 주석을 포함하도록 BylineImpl.java을(를) 업데이트합니다.

    code language-java
    import org.apache.sling.models.factory.ModelFactory;
    import org.apache.sling.models.annotations.injectorspecific.OSGiService;
    ...
    public class BylineImpl implements Byline {
        ...
        @OSGiService
        private ModelFactory modelFactory;
    }
    

    ModelFactory을(를) 사용하면 다음을 사용하여 핵심 구성 요소 이미지 슬링 모델을 만들 수 있습니다.

    code language-java
    modelFactory.getModelFromWrappedRequest(SlingHttpServletRequest request, Resource resource, java.lang.Class<T> targetClass)
    

    그러나 이 메서드는 Sling 모델에서 아직 사용할 수 없는 요청과 리소스를 모두 필요로 합니다. 이를 위해 더 많은 Sling 모델 주석이 사용됩니다!

    현재 요청을 가져오려면 @Self 주석을 사용하여 @Model(..)에서 SlingHttpServletRequest.class(으)로 정의된 adaptable을(를) Java™ 클래스 필드에 삽입할 수 있습니다.

  3. @Self 주석을 추가하여 SlingHttpServletRequest ​을(를) 가져옵니다.

    code language-java
    import org.apache.sling.models.annotations.injectorspecific.Self;
    ...
    @Self
    private SlingHttpServletRequest request;
    

    @Self Image image을(를) 사용하여 핵심 구성 요소 이미지 Sling 모델을 삽입하는 것은 위의 옵션입니다. @Self 주석은 조정 가능한 개체(이 경우 SlingHttpServletRequest)를 삽입하고 주석 필드 유형에 맞게 조정하려고 합니다. 핵심 구성 요소의 이미지 Sling 모델은 SlingHttpServletRequest 개체에서 조정할 수 있으므로 더 탐색적인 modelFactory 방식보다 더 효과적이고 코드가 적습니다.

    이제 ModelFactory API를 통해 이미지 모델을 인스턴스화하는 데 필요한 변수가 삽입되었습니다. Sling 모델이 인스턴스화된 후 Sling 모델의 @PostConstruct 주석을 사용하여 이 개체를 가져오겠습니다.

    @PostConstruct은(는) 매우 유용하며 생성자와 비슷한 용량으로 작동하지만 클래스가 인스턴스화되고 주석이 지정된 모든 Java™ 필드가 주입된 후 호출됩니다. 다른 Sling 모델 주석은 Java™ 클래스 필드(변수)에 주석을 달지만 @PostConstruct은(는) 일반적으로 init()(그러나 다른 이름으로 명명될 수 있음)이라는 빈 매개 변수 메서드에 주석을 달습니다.

  4. @PostConstruct 메서드 추가:

    code language-java
    import javax.annotation.PostConstruct;
    ...
    public class BylineImpl implements Byline {
        ...
        private Image image;
    
        @PostConstruct
        private void init() {
            image = modelFactory.getModelFromWrappedRequest(request,
                                                            request.getResource(),
                                                            Image.class);
        }
        ...
    }
    

    Sling 모델은 NOT OSGi 서비스이므로 클래스 상태를 유지해도 안전합니다. @PostConstruct은(는) 일반 생성자가 수행하는 작업과 유사한 방식으로 나중에 사용할 수 있도록 Sling Model 클래스 상태를 파생하고 설정하는 경우가 많습니다.

    @PostConstruct 메서드에서 예외가 발생하면 Sling 모델이 인스턴스화되지 않고 null입니다.

  5. 이제 이미지 개체를 반환하도록 getImage() ​을(를) 업데이트할 수 있습니다.

    code language-java
    /**
        * @return the Image Sling Model of this resource, or null if the resource cannot create a valid Image Sling Model.
    */
    private Image getImage() {
        return image;
    }
    
  6. isEmpty()(으)로 돌아가서 구현을 마치겠습니다.

    code language-java
    @Override
    public boolean isEmpty() {
       final Image componentImage = getImage();
    
        if (StringUtils.isBlank(name)) {
            // Name is missing, but required
            return true;
        } else if (occupations == null || occupations.isEmpty()) {
            // At least one occupation is required
            return true;
        } else if (componentImage == null || StringUtils.isBlank(componentImage.getSrc())) {
            // A valid image is required
            return true;
        } else {
            // Everything is populated, so this component is not considered empty
            return false;
        }
    }
    

    초기화된 image 클래스 변수를 반환하고 비용이 많이 들지 않지만 불필요하게 호출하지 않는 modelFactory.getModelFromWrappedRequest(...)을(를) 호출하지 않으므로 getImage()에 대한 여러 호출은 문제가 되지 않습니다.

  7. 최종 BylineImpl.java은(는) 다음과 같아야 합니다.

    code language-java
    package com.adobe.aem.guides.wknd.core.models.impl;
    
    import java.util.ArrayList;
    import java.util.Collections;
    import java.util.List;
    import javax.annotation.PostConstruct;
    import org.apache.commons.lang3.StringUtils;
    import org.apache.sling.api.SlingHttpServletRequest;
    import org.apache.sling.models.annotations.DefaultInjectionStrategy;
    import org.apache.sling.models.annotations.Model;
    import org.apache.sling.models.annotations.injectorspecific.OSGiService;
    import org.apache.sling.models.annotations.injectorspecific.Self;
    import org.apache.sling.models.annotations.injectorspecific.ValueMapValue;
    import org.apache.sling.models.factory.ModelFactory;
    import com.adobe.aem.guides.wknd.core.models.Byline;
    import com.adobe.cq.wcm.core.components.models.Image;
    
    @Model(
            adaptables = {SlingHttpServletRequest.class},
            adapters = {Byline.class},
            resourceType = {BylineImpl.RESOURCE_TYPE},
            defaultInjectionStrategy = DefaultInjectionStrategy.OPTIONAL
    )
    public class BylineImpl implements Byline {
        protected static final String RESOURCE_TYPE = "wknd/components/byline";
    
        @Self
        private SlingHttpServletRequest request;
    
        @OSGiService
        private ModelFactory modelFactory;
    
        @ValueMapValue
        private String name;
    
        @ValueMapValue
        private List<String> occupations;
    
        private Image image;
    
        /**
        * @PostConstruct is immediately called after the class has been initialized
        * but BEFORE any of the other public methods.
        * It is a good method to initialize variables that is used by methods in the rest of the model
        *
        */
        @PostConstruct
        private void init() {
            // set the image object
            image = modelFactory.getModelFromWrappedRequest(request, request.getResource(), Image.class);
        }
    
        @Override
        public String getName() {
            return name;
        }
    
        @Override
        public List<String> getOccupations() {
            if (occupations != null) {
                Collections.sort(occupations);
                return new ArrayList<String>(occupations);
            } else {
                return Collections.emptyList();
            }
        }
    
        @Override
        public boolean isEmpty() {
            final Image componentImage = getImage();
    
            if (StringUtils.isBlank(name)) {
                // Name is missing, but required
                return true;
            } else if (occupations == null || occupations.isEmpty()) {
                // At least one occupation is required
                return true;
            } else if (componentImage == null || StringUtils.isBlank(componentImage.getSrc())) {
                // A valid image is required
                return true;
            } else {
                // Everything is populated, so this component is not considered empty
                return false;
            }
        }
    
        /**
        * @return the Image Sling Model of this resource, or null if the resource cannot create a valid Image Sling Model.
        */
        private Image getImage() {
            return image;
        }
    }
    

바이라인 HTL byline-htl

ui.apps 모듈에서 AEM 구성 요소의 이전 설정에서 만든 /apps/wknd/components/byline/byline.html을(를) 엽니다.

<div data-sly-use.placeholderTemplate="core/wcm/components/commons/v1/templates.html">
</div>
<sly data-sly-call="${placeholderTemplate.placeholder @ isEmpty=false}"></sly>

지금까지 이 HTL 스크립트가 수행하는 작업을 검토해 보겠습니다.

  • placeholderTemplate은(는) 구성 요소가 완전히 구성되지 않았을 때 표시되는 핵심 구성 요소의 자리 표시자를 가리킵니다. 이렇게 하면 AEM Sites 페이지 편집기에서 cq:Componentjcr:title 속성에서 위에 정의된 대로 구성 요소 제목이 있는 상자로 렌더링됩니다.

  • data-sly-call="${placeholderTemplate.placeholder @ isEmpty=false}은(는) 위에 정의된 placeholderTemplate을(를) 로드하고 부울 값(현재 false에 하드 코딩됨)을 자리 표시자 템플릿으로 전달합니다. isEmpty이(가) true인 경우 자리 표시자 템플릿은 회색 상자를 렌더링하고, 그렇지 않으면 아무 것도 렌더링하지 않습니다.

인라인 HTL 업데이트

  1. 다음 골격 HTML 구조로 byline.html ​을(를) 업데이트합니다.

    code language-html
    <div data-sly-use.placeholderTemplate="core/wcm/components/commons/v1/templates.html"
        class="cmp-byline">
            <div class="cmp-byline__image">
                <!--/* Include the Core Components Image Component */-->
            </div>
            <h2 class="cmp-byline__name"><!--/* Include the name */--></h2>
            <p class="cmp-byline__occupations"><!--/* Include the occupations */--></p>
    </div>
    <sly data-sly-call="${placeholderTemplate.placeholder @ isEmpty=true}"></sly>
    

    CSS 클래스는 BEM 명명 규칙을 따릅니다. BEM 규칙은 필수가 아니지만, 핵심 구성 요소 CSS 클래스에서 사용되며 일반적으로 읽을 수 있는 깔끔한 CSS 규칙을 만들기 때문에 BEM이 권장됩니다.

HTL에서 Sling 모델 개체 인스턴스화 instantiating-sling-model-objects-in-htl

블록 문 사용은(는) HTL 스크립트에서 Sling 모델 개체를 인스턴스화하고 HTL 변수에 할당하는 데 사용됩니다.

data-sly-use.byline="com.adobe.aem.guides.wknd.models.Byline"은(는) BylineImpl에 의해 구현된 Byline 인터페이스(com.adobe.aem.guides.wknd.models.Byline)를 사용하며 현재 SlingHttpServletRequest를 이 인터페이스에 맞게 조정하며 결과는 HTL 변수 이름 byline( data-sly-use.<variable-name>)에 저장됩니다.

  1. 공용 인터페이스에서 Byline Sling 모델을 참조하도록 외부 div을(를) 업데이트합니다.

    code language-xml
    <div data-sly-use.byline="com.adobe.aem.guides.wknd.core.models.Byline"
        data-sly-use.placeholderTemplate="core/wcm/components/commons/v1/templates.html"
        class="cmp-byline">
        ...
    </div>
    

Sling 모델 메서드 액세스 accessing-sling-model-methods

HTL은 JSTL에서 가져오며 동일한 단축의 Java™ getter 메서드 이름을 사용합니다.

예를 들어 Byline Sling 모델의 getName() 메서드를 호출하는 경우 byline.isEmpty이(가) 아닌 byline.name(으)로 단축될 수 있습니다. 마찬가지로 이 메서드는 byline.empty(으)로 단축될 수 있습니다. 전체 메서드 이름 byline.getName 또는 byline.isEmpty을(를) 사용하는 것도 가능합니다. ()은(는) JSTL과 유사한 HTL에서 메서드를 호출하는 데 사용되지 않습니다.

매개 변수 이(가) 필요한 Java™ 메서드는 HTL에서 사용할 수 없습니다. 이는 HTL의 논리를 간단하게 유지하기 위한 것입니다.

  1. Byline Sling 모델 또는 HTL에서 getName() 메서드를 호출하여 Byline 이름을 구성 요소에 추가할 수 있습니다. ${byline.name}.

    h2 태그 업데이트:

    code language-xml
    <h2 class="cmp-byline__name">${byline.name}</h2>
    

HTL 표현식 옵션 사용 using-htl-expression-options

HTL 표현식 옵션은(는) HTL의 콘텐츠에 대한 수정자 역할을 하며 날짜 형식부터 i18n 변환까지 다양합니다. 표현식은 쉼표로 구분된 형식으로 작업을 표시하는 데 필요한 목록이나 값 배열을 결합하는 데 사용할 수도 있습니다.

HTL 식의 @ 연산자를 통해 식이 추가됩니다.

  1. ", "로 작업 목록을 조인하려면 다음 코드를 사용합니다.

    code language-html
    <p class="cmp-byline__occupations">${byline.occupations @ join=', '}</p>
    

조건부로 자리 표시자 표시 conditionally-displaying-the-placeholder

AEM 구성 요소용 HTL 스크립트는 자리 표시자 패러다임 ​을 사용하여 구성 요소가 잘못 작성되고 AEM Publish 에 표시되지 않음을 나타내는 시각적 큐를 작성자 ​에게 제공합니다. 이 결정을 유도하는 규칙은 구성 요소의 지원 Sling 모델에서 메서드를 구현하는 것입니다(이 경우: Byline.isEmpty()).

isEmpty() 메서드가 Byline Sling 모델에서 호출되고 결과(또는 ! 연산자를 통해 음수)가 이름이 hasContent인 HTL 변수에 저장됩니다.

  1. 외부 div을(를) 업데이트하여 이름이 hasContent인 HTL 변수를 저장합니다.

    code language-html
     <div data-sly-use.byline="com.adobe.aem.guides.wknd.core.models.Byline"
          data-sly-use.placeholderTemplate="core/wcm/components/commons/v1/templates.html"
          data-sly-test.hasContent="${!byline.empty}"
          class="cmp-byline">
          ...
    </div>
    

    data-sly-test을(를) 사용하는 것이 중요합니다. HTL test 블록은 모두 HTL 변수를 설정하고 해당 HTML 요소를 렌더링/렌더링하지 않습니다. HTL 표현식 평가 결과를 기반으로 합니다. true이면 HTML 요소가 렌더링되고 그렇지 않으면 렌더링되지 않습니다.

    이제 이 HTL 변수 hasContent을(를) 사용하여 조건부로 자리 표시자를 표시하거나 숨길 수 있습니다.

  2. 파일 하단의 placeholderTemplate에 대한 조건부 호출을 다음과 같이 업데이트합니다.

    code language-html
    <sly data-sly-call="${placeholderTemplate.placeholder @ isEmpty=!hasContent}"></sly>
    

핵심 구성 요소를 사용하여 이미지 표시 using-the-core-components-image

byline.html에 대한 HTL 스크립트가 이제 거의 완료되었으며 이미지만 없습니다.

sling:resourceSuperType이(가) 이미지를 작성할 핵심 구성 요소의 이미지 구성 요소를 가리키면 핵심 구성 요소의 이미지 구성 요소를 사용하여 이미지를 렌더링할 수 있습니다.

이를 위해 현재 byline 리소스를 포함하지만 리소스 유형 core/wcm/components/image/v2/image을(를) 사용하여 핵심 구성 요소의 이미지 구성 요소에 리소스 유형을 강제 적용해 보겠습니다. 이는 구성 요소 재사용을 위한 강력한 패턴입니다. 이를 위해 HTL의 data-sly-resource 블록이 사용됩니다.

  1. div을(를) cmp-byline__image 클래스로 다음과 같이 바꿉니다.

    code language-html
    <div class="cmp-byline__image"
        data-sly-resource="${ '.' @ resourceType = 'core/wcm/components/image/v2/image' }"></div>
    

    data-sly-resource은(는) 상대 경로 '.'을(를) 통해 현재 리소스를 포함하며 리소스 유형이 core/wcm/components/image/v2/image인 현재 리소스(또는 byline 콘텐츠 리소스)를 포함하도록 강제합니다.

    핵심 구성 요소 리소스 유형은 스크립트 내 사용이며 콘텐츠로 지속되지 않으므로 프록시를 통하지 않고 직접 사용됩니다.

  2. 아래 byline.html을(를) 완료했습니다.

    code language-html
    <!--/* byline.html */-->
    <div data-sly-use.byline="com.adobe.aem.guides.wknd.core.models.Byline"
        data-sly-use.placeholderTemplate="core/wcm/components/commons/v1/templates.html"
        data-sly-test.hasContent="${!byline.empty}"
        class="cmp-byline">
        <div class="cmp-byline__image"
            data-sly-resource="${ '.' @ resourceType = 'core/wcm/components/image/v2/image' }">
        </div>
        <h2 class="cmp-byline__name">${byline.name}</h2>
        <p class="cmp-byline__occupations">${byline.occupations @ join=', '}</p>
    </div>
    <sly data-sly-call="${placeholderTemplate.placeholder @ isEmpty=!hasContent}"></sly>
    
  3. 로컬 AEM 인스턴스에 코드 베이스를 배포합니다. coreui.apps이(가) 변경되었으므로 두 모듈을 배포해야 합니다.

    code language-shell
    $ cd aem-guides-wknd/ui.apps
    $ mvn clean install -PautoInstallPackage
    
    code language-shell
    $ cd ../core
    $ mvn clean install -PautoInstallBundle
    

    AEM 6.5/6.4로 배포하려면 classic 프로필을 호출하십시오.

    code language-shell
    $ cd ../core
    $ mvn clean install -PautoInstallBundle -Pclassic
    
    note caution
    CAUTION
    Maven 프로필 autoInstallSinglePackage을(를) 사용하여 루트에서 전체 프로젝트를 빌드할 수도 있지만 이는 페이지의 콘텐츠 변경 사항을 덮어쓸 수 있습니다. 튜토리얼 시작 코드가 기존 AEM 콘텐츠를 완전히 덮어쓸 수 있도록 ui.content/src/main/content/META-INF/vault/filter.xml이(가) 수정되었기 때문입니다. 실제 시나리오에서는 이것이 문제가 아닙니다.

스타일이 지정되지 않은 Byline 구성 요소 검토 reviewing-the-unstyled-byline-component

  1. 업데이트를 배포한 후 LA Skateparks에 대한 Ultimate 안내서 페이지로 이동하거나, 챕터 앞부분에서 Byline 구성 요소를 추가한 위치로 이동합니다.

  2. 이제 이미지, 이름직업 ​이 나타나고 스타일이 지정되지 않았지만 작동하는 Byline 구성 요소가 있습니다.

    스타일이 지정되지 않은 byline 구성 요소

Sling 모델 등록 검토 reviewing-the-sling-model-registration

AEM 웹 콘솔의 Sling 모델 상태 보기는 AEM에 등록된 모든 Sling 모델을 표시합니다. 이 목록을 검토하여 Byline Sling 모델이 설치되어 있는지 확인하고 인식되었는지 확인할 수 있습니다.

BylineImpl ​이(가) 이 목록에 표시되지 않으면 슬링 모델의 주석에 문제가 있거나 모델이 핵심 프로젝트의 올바른 패키지(com.adobe.aem.guides.wknd.core.models)에 추가되지 않았을 수 있습니다.

Byline Sling 모델이 등록됨

http://localhost:4502/system/console/status-slingmodels

줄 스타일 byline-styles

Byline 구성 요소를 제공된 크리에이티브 디자인에 맞추기 위해 스타일링해 보겠습니다. 이 작업은 SCSS 파일을 사용하고 ui.frontend 모듈에서 파일을 업데이트하여 수행할 수 있습니다.

기본 스타일 추가

Byline 구성 요소의 기본 스타일을 추가합니다.

  1. IDE 및 /src/main/webpack/componentsui.frontend 프로젝트로 돌아가기:

  2. 이름이 _byline.scss인 파일을 만듭니다.

    byline 프로젝트 탐색기

  3. SCSS로 작성된 Byline 구현 CSS를 _byline.scss에 추가합니다.

    code language-scss
    .cmp-byline {
        $imageSize: 60px;
    
        .cmp-byline__image {
            float: left;
    
        /* This class targets a Core Component Image CSS class */
        .cmp-image__image {
            width: $imageSize;
            height: $imageSize;
            border-radius: $imageSize / 2;
            object-fit: cover;
            }
        }
    
        .cmp-byline__name {
            font-size: $font-size-medium;
            font-family: $font-family-serif;
            padding-top: 0.5rem;
            margin-left: $imageSize + 25px;
            margin-bottom: .25rem;
            margin-top:0rem;
        }
    
        .cmp-byline__occupations {
            margin-left: $imageSize + 25px;
            color: $gray;
            font-size: $font-size-xsmall;
            text-transform: uppercase;
        }
    }
    
  4. 터미널을 열고 ui.frontend 모듈로 이동합니다.

  5. 다음 npm 명령을 사용하여 watch 프로세스를 시작합니다.

    code language-shell
    $ cd ui.frontend/
    $ npm run watch
    
  6. 브라우저로 돌아가서 LA SkateParks 문서(으)로 이동합니다. 구성 요소에 업데이트된 스타일이 표시됩니다.

    줄 구성 요소를 마쳤습니다

    note tip
    TIP
    오래된 CSS가 제공되지 않도록 브라우저 캐시를 지우고 전체 스타일을 가져오려면 Byline 구성 요소로 페이지를 새로 고쳐야 할 수 있습니다.

축하합니다! congratulations

축하합니다. Adobe Experience Manager을 사용하여 처음부터 사용자 지정 구성 요소를 만들었습니다!

다음 단계 next-steps

모든 것이 제대로 개발되고 구현된 비즈니스 논리가 올바르고 완전한지 확인하기 위해 Byline Java™ 코드에 대한 JUnit 테스트를 작성하는 방법을 탐색하여 AEM 구성 요소 개발에 대해 계속 알아보십시오.

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

  1. github.com/adobe/aem-guides-wknd 리포지토리를 복제합니다.
  2. tutorial/custom-component-solution 분기 체크 아웃
recommendation-more-help
b2a561c1-47c0-4182-b8c1-757a197484f9