편집 가능한 컨테이너 구성 요소

고정 구성 요소는 SPA 콘텐츠를 작성하는 데 약간의 유연성을 제공하지만, 이 방법은 엄격하여 개발자가 편집 가능한 콘텐츠의 정확한 구성을 정의해야 합니다. 작성자가 탁월한 경험을 만들 수 있도록 SPA Editor는 SPA에서 컨테이너 구성 요소를 사용할 수 있도록 지원합니다. 작성자는 컨테이너 구성 요소를 통해 허용된 구성 요소를 드래그하여 컨테이너에 넣고, 기존 AEM Sites 작성에서와 마찬가지로 이 구성 요소를 작성할 수 있습니다.

편집 가능한 컨테이너 구성 요소

이 장에서는 작성자가 SPA에서 바로 Editable React 구성 요소를 사용하여 풍부한 콘텐츠 경험을 구성하고 레이아웃할 수 있도록 하는 편집 가능한 컨테이너를 홈 보기에 추가합니다.

WKND 앱 업데이트

컨테이너 구성 요소를 홈 보기에 추가하려면 다음을 수행합니다.

  • AEM React Editable 구성 요소의 ResponsiveGrid 구성 요소 가져오기
  • ResponsiveGrid 구성 요소에서 사용할 사용자 지정 Editable React 구성 요소(텍스트 및 이미지)를 가져와서 등록합니다

ResponsiveGrid 구성 요소 사용

편집 가능한 영역을 홈 보기에 추가하려면 다음을 수행합니다.

  1. react-app/src/components/Home.js 열기 및 편집

  2. @adobe/aem-react-editable-components에서 ResponsiveGrid 구성 요소를 가져와 Home 구성 요소에 추가하십시오.

  3. <ResponsiveGrid...> 구성 요소에서 다음 특성을 설정합니다.

    • pagePath = '/content/wknd-app/us/en/home'
    • itemPath = 'root/responsivegrid'

    ResponsiveGrid 구성 요소가 AEM 리소스에서 해당 콘텐츠를 검색하도록 지시합니다.

    • /content/wknd-app/us/en/home/jcr:content/root/responsivegrid

    itemPath은(는) Remote SPA Page AEM 템플릿에 정의된 responsivegrid 노드에 매핑되며 Remote SPA Page AEM 템플릿에서 만든 새 AEM 페이지에 자동으로 만들어집니다.

    Home.js을(를) 업데이트하여 <ResponsiveGrid...> 구성 요소를 추가합니다.

    code language-javascript
    ...
    import { ResponsiveGrid } from '@adobe/aem-react-editable-components';
    ...
    
    function Home() {
        return (
            <div className="Home">
                <ResponsiveGrid
                    pagePath='/content/wknd-app/us/en/home'
                    itemPath='root/responsivegrid'/>
    
                <EditableTitle
                    pagePath='/content/wknd-app/us/en/home'
                    itemPath='title'/>
    
                <Adventures />
            </div>
        );
    }
    

Home.js 파일은 다음과 같아야 합니다.

Home.js

편집 가능한 구성 요소 만들기

SPA Editor에서 제공하는 유연한 작성 경험 컨테이너를 최대한 활용하십시오. 이미 편집 가능한 제목 구성 요소를 만들었지만 작성자가 새로 추가된 ResponsiveGrid 구성 요소에서 편집 가능한 텍스트 및 이미지 구성 요소를 사용할 수 있도록 하는 몇 가지 사항을 더 만들어 보겠습니다.

새로운 편집 가능한 텍스트 및 이미지 반응 구성 요소는 편집 가능한 고정 구성 요소에 노출된 편집 가능한 구성 요소 정의 패턴을 사용하여 만들어집니다.

편집 가능한 텍스트 구성 요소

  1. IDE에서 SPA 프로젝트 열기

  2. src/components/editable/core/Text.js에서 React 구성 요소 만들기

  3. Text.js에 다음 코드 추가

    code language-javascript
    import React from 'react'
    
    const TextPlain = (props) => <div className={props.baseCssClass}><p className="cmp-text__paragraph">{props.text}</p></div>;
    const TextRich = (props) => {
    const text = props.text;
    const id = (props.id) ? props.id : (props.cqPath ? props.cqPath.substr(props.cqPath.lastIndexOf('/') + 1) : "");
        return <div className={props.baseCssClass} id={id} data-rte-editelement dangerouslySetInnerHTML={{ __html: text }} />
    };
    
    export const Text = (props) => {
        if (!props.baseCssClass) {
            props.baseCssClass = 'cmp-text'
        }
    
        const { richText = false } = props
    
        return richText ? <TextRich {...props} /> : <TextPlain {...props} />
        }
    
        export function textIsEmpty(props) {
        return props.text == null || props.text.length === 0;
    }
    
  4. src/components/editable/EditableText.js에서 편집 가능한 React 구성 요소를 만듭니다.

  5. EditableText.js에 다음 코드 추가

    code language-javascript
    import React from 'react'
    import { EditableComponent, MapTo } from '@adobe/aem-react-editable-components';
    import { Text, textIsEmpty } from "./core/Text";
    import { withConditionalPlaceHolder } from "./core/util/withConditionalPlaceholder";
    import { withStandardBaseCssClass } from "./core/util/withStandardBaseCssClass";
    
    const RESOURCE_TYPE = "wknd-app/components/text";
    
    const EditConfig = {
        emptyLabel: "Text",
        isEmpty: textIsEmpty,
        resourceType: RESOURCE_TYPE
    };
    
    export const WrappedText = (props) => {
        const Wrapped = withConditionalPlaceHolder(withStandardBaseCssClass(Text, "cmp-text"), textIsEmpty, "Text V2")
        return <Wrapped {...props} />
    };
    
    const EditableText = (props) => <EditableComponent config={EditConfig} {...props}><WrappedText /></EditableComponent>
    
    MapTo(RESOURCE_TYPE)(EditableText);
    
    export default EditableText;
    

편집 가능한 텍스트 구성 요소 구현은 다음과 같아야 합니다.

편집 가능한 텍스트 구성 요소

이미지 구성 요소

  1. IDE에서 SPA 프로젝트 열기

  2. src/components/editable/core/Image.js에서 React 구성 요소 만들기

  3. Image.js에 다음 코드 추가

    code language-javascript
    import React from 'react'
    import { RoutedLink } from "./RoutedLink";
    
    export const imageIsEmpty = (props) => (!props.src) || props.src.trim().length === 0
    
    const ImageInnerContents = (props) => {
    return (<>
        <img src={props.src}
            className={props.baseCssClass + '__image'}
            alt={props.alt} />
        {
            !!(props.title) && <span className={props.baseCssClass + '__title'} itemProp="caption">{props.title}</span>
        }
        {
            props.displayPopupTitle && (!!props.title) && <meta itemProp="caption" content={props.title} />
        }
        </>);
    };
    
    const ImageContents = (props) => {
        if (props.link && props.link.trim().length > 0) {
            return (
            <RoutedLink className={props.baseCssClass + '__link'} isRouted={props.routed} to={props.link}>
                <ImageInnerContents {...props} />
            </RoutedLink>
            )
        }
        return <ImageInnerContents {...props} />
    };
    
    export const Image = (props) => {
        if (!props.baseCssClass) {
            props.baseCssClass = 'cmp-image'
        }
    
        const { isInEditor = false } = props;
        const cssClassName = (isInEditor) ? props.baseCssClass + ' cq-dd-image' : props.baseCssClass;
    
        return (
            <div className={cssClassName}>
                <ImageContents {...props} />
            </div>
        )
    };
    
  4. src/components/editable/EditableImage.js에서 편집 가능한 React 구성 요소를 만듭니다.

  5. EditableImage.js에 다음 코드 추가

import { EditableComponent, MapTo } from '@adobe/aem-react-editable-components';
import { Image, imageIsEmpty } from "./core/Image";
import React from 'react'

import { withConditionalPlaceHolder } from "./core/util/withConditionalPlaceholder";
import { withStandardBaseCssClass } from "./core/util/withStandardBaseCssClass";

const RESOURCE_TYPE = "wknd-app/components/image";

const EditConfig = {
    emptyLabel: "Image",
    isEmpty: imageIsEmpty,
    resourceType: RESOURCE_TYPE
};

const WrappedImage = (props) => {
    const Wrapped = withConditionalPlaceHolder(withStandardBaseCssClass(Image, "cmp-image"), imageIsEmpty, "Image V2");
    return <Wrapped {...props}/>
}

const EditableImage = (props) => <EditableComponent config={EditConfig} {...props}><WrappedImage /></EditableComponent>

MapTo(RESOURCE_TYPE)(EditableImage);

export default EditableImage;
  1. EditableImage.scss에 대한 사용자 지정 스타일을 제공하는 SCSS 파일 src/components/editable/EditableImage.scss을(를) 만듭니다. 이러한 스타일은 편집 가능한 React 구성 요소의 CSS 클래스를 대상으로 합니다.

  2. EditableImage.scss에 다음 SCSS 추가

    code language-css
    .cmp-image__image {
        margin: 1rem 0;
        width: 100%;
        border: 0;
     }
    
  3. EditableImage.js에서 EditableImage.scss 가져오기

    code language-javascript
    ...
    import './EditableImage.scss';
    ...
    

편집 가능한 이미지 구성 요소 구현은 다음과 같아야 합니다.

편집 가능한 이미지 구성 요소

편집 가능한 구성 요소 가져오기

새로 만든 EditableTextEditableImage React 구성 요소는 SPA에서 참조되며 AEM에서 반환된 JSON을 기반으로 동적으로 인스턴스화됩니다. 이러한 구성 요소를 SPA에서 사용할 수 있도록 하려면 Home.js에서 해당 구성 요소에 대한 가져오기 문을 만드십시오.

  1. IDE에서 SPA 프로젝트 열기

  2. src/Home.js 파일을 엽니다.

  3. AEMTextAEMImage에 대한 가져오기 문 추가

    code language-javascript
    ...
    // The following need to be imported, so that MapTo is run for the components
    import EditableText from './editable/EditableText';
    import EditableImage from './editable/EditableImage';
    ...
    

결과는 다음과 같아야 합니다.

Home.js

이 가져오기가 not 추가된 경우 EditableTextEditableImage 코드가 SPA에 의해 호출되지 않으므로 구성 요소가 제공된 리소스 형식에 매핑되지 않습니다.

AEM에서 컨테이너 구성

AEM 컨테이너 구성 요소는 정책을 사용하여 허용된 구성 요소를 지시합니다. SPA Editor는 SPA 구성 요소 대응 요소를 매핑한 AEM 구성 요소만 SPA에서 렌더링할 수 있으므로 중요한 구성입니다. SPA 구현을 제공한 구성 요소만 허용되는지 확인하십시오.

  • EditableTitle이(가) wknd-app/components/title에 매핑됨
  • EditableText이(가) wknd-app/components/text에 매핑됨
  • EditableImage이(가) wknd-app/components/image에 매핑됨

원격 SPA 페이지 템플릿의 reponsivegrid 컨테이너를 구성하려면 다음과 같이 하십시오.

  1. AEM 작성자에 로그인

  2. 도구 > 일반 > 템플릿 > WKND 앱으로 이동

  3. 보고서 SPA 페이지 편집

    응답형 격자 정책

  4. 오른쪽 상단의 모드 전환기에서 구조 ​를 선택합니다.

  5. 탭하여 레이아웃 컨테이너 선택

  6. 팝업 막대에서 정책 아이콘을 탭합니다.

    응답형 격자 정책

  7. 오른쪽의 허용된 구성 요소 탭에서 WKND 앱 - 콘텐츠 ​를 확장합니다.

  8. 다음 항목만 선택해야 합니다.

    • 이미지
    • 텍스트
    • 제목

    원격 SPA 페이지

  9. 완료

AEM에서 컨테이너 작성

SPA이 <ResponsiveGrid...>을(를) 포함하도록 업데이트되고, 세 개의 편집 가능한 React 구성 요소(EditableTitle, EditableTextEditableImage)에 대한 래퍼가 업데이트되고, AEM이 일치하는 템플릿 정책으로 업데이트되면 컨테이너 구성 요소에서 콘텐츠 작성을 시작할 수 있습니다.

  1. AEM 작성자에 로그인

  2. 사이트 > WKND 앱(으)로 이동

  3. ​을 탭하고 맨 위의 작업 표시줄에서 편집 ​을 선택합니다.

    • AEM Project Archetype에서 프로젝트를 생성할 때 자동으로 추가되었으므로 "Hello World" 텍스트 구성 요소가 표시됩니다
  4. 페이지 편집기의 오른쪽 상단에 있는 모드 선택기에서 편집 ​을 선택합니다.

  5. 제목 아래에서 레이아웃 컨테이너 편집 가능 영역을 찾습니다.

  6. 페이지 편집기의 사이드바 ​를 열고 구성 요소 보기 ​를 선택합니다.

  7. 다음 구성 요소를 레이아웃 컨테이너(으)로 끌어옵니다.

    • 이미지
    • 제목
  8. 구성 요소를 드래그하여 다음 순서로 순서를 변경합니다.

    1. 제목
    2. 이미지
    3. 텍스트
  9. 제목 구성 요소를 작성자

    1. 제목 구성 요소를 탭하고 렌치 아이콘을 탭하여 제목 구성 요소를 편집 ​합니다.

    2. 다음 텍스트를 추가합니다.

      • 제목: 여름이 다가오고 있습니다. 최대한 활용해 보세요!
      • 유형: H1
    3. 완료

  10. 이미지 구성 요소 작성자

    1. 이미지 구성 요소의 측면 막대(Assets 보기로 전환한 후)에서 이미지를 드래그합니다
    2. 이미지 구성 요소를 탭하고 렌치 아이콘을 탭하여 편집합니다
    3. 이미지가 장식용임 확인란을 선택하십시오.
    4. 완료
  11. 텍스트 구성 요소를 작성자

    1. 텍스트 구성 요소를 탭하고 렌치 아이콘을 탭하여 텍스트 구성 요소를 편집합니다
    2. 다음 텍스트를 추가합니다.
      • 현재 1주일 모험은 15%, 2주 이상 모험은 20% 할인됩니다! 체크아웃할 때 캠페인 코드 SUMMERISCOMING을 추가하여 할인 혜택을 받으십시오!
    3. 완료
  12. 이제 구성 요소가 작성되었지만 세로로 스택됩니다.

    작성된 구성 요소

구성 요소의 크기와 레이아웃을 조정할 수 있도록 AEM의 레이아웃 모드 를 사용하십시오.

  1. 오른쪽 상단의 모드 선택기를 사용하여 레이아웃 모드(으)로 전환

  2. 이미지 및 텍스트 구성 요소가 나란히 표시되도록 크기 조정

    • 이미지 구성 요소는 8열 ​이어야 합니다.
    • 텍스트 구성 요소는 3열 너비여야 함

    레이아웃 구성 요소

  3. AEM 페이지 편집기에서 변경 내용을 미리 보기

  4. http://localhost:3000에서 로컬로 실행 중인 WKND 앱을 새로 고쳐 작성된 변경 내용을 확인합니다.

    SPA의 컨테이너 구성 요소

축하합니다!

작성자가 편집 가능한 구성 요소를 WKND 앱에 추가할 수 있는 컨테이너 구성 요소를 추가했습니다. 이제 다음 방법을 이해할 수 있습니다.

  • SPA에서 AEM React Editable 구성 요소의 ResponsiveGrid 구성 요소 사용
  • 컨테이너 구성 요소를 통해 SPA에서 사용할 편집 가능한 React 구성 요소(텍스트 및 이미지)를 만들고 등록합니다
  • SPA 지원 구성 요소를 허용하도록 원격 SPA 페이지 템플릿 구성
  • 컨테이너 구성 요소에 편집 가능한 구성 요소 추가
  • SPA Editor에서 구성 요소 작성 및 레이아웃

다음 단계

다음 단계에서는 이와 동일한 기술을 사용하여 편집 가능한 구성 요소를 SPA의 Adventure Details 경로에 추가합니다.

recommendation-more-help
e25b6834-e87f-4ff3-ba56-4cd16cdfdec4