에뮬레이터 emulators

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
Developing

작성 대상:

Developer

CAUTION

AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

NOTE

단일 페이지 애플리케이션 프레임워크 기반 클라이언트측 렌더링(예: React)이 필요한 프로젝트에 SPA 편집기를 사용하는 것이 좋습니다. 자세히 알아보기.

Adobe Experience Manager(AEM)을 사용하면 작성자가 모바일 장치나 이메일 클라이언트와 같이 최종 사용자가 페이지를 볼 환경을 시뮬레이션하는 에뮬레이터에서 페이지를 볼 수 있습니다.

AEM 에뮬레이터 프레임워크:

모바일 장치 또는 이메일 클라이언트(뉴스레터를 작성하는 데 사용됨)와 같은 시뮬레이션된 UI(사용자 인터페이스)에서 컨텐츠 작성을 제공합니다.
시뮬레이션한 UI에 따라 페이지 컨텐츠를 조정합니다.
사용자 정의 에뮬레이터를 만들 수 있습니다.

CAUTION

이 기능은 클래식 UI에서만 지원됩니다.

에뮬레이터 특성 emulators-characteristics

에뮬레이터:

는 ExtJS를 기반으로 합니다.
페이지 DOM에서 작동합니다.
모양은 CSS를 통해 규제됩니다.
플러그인(예: 모바일 장치 회전 플러그인)을 지원합니다.
작성자에서만 활성 상태입니다.
기본 구성 요소는 입니다. /libs/wcm/emulator/components/base.

에뮬레이터가 컨텐츠를 변환하는 방법 how-the-emulator-transforms-the-content

에뮬레이터는 HTML 본문 내용을 에뮬레이터 DIV로 래핑하여 작동합니다. 예를 들어 다음 html 코드가 있습니다.

<body>
<div id="wrapper" class="page mobilecontentpage ">
    <div class="topnav mobiletopnav">
    ...
    </div>
    ...
</div>
</body>

는 에뮬레이터가 시작된 후 다음 html 코드로 변환됩니다.

<body>
 <div id="cq-emulator-toolbar">
 ...
 </div>
 <div id="cq-emulator-wrapper">
  <div id="cq-emulator-device">
   <div class=" android vertical" id="cq-emulator">
    ...
    <div class=" android vertical" id="cq-emulator-content">
     ...
     <div id="wrapper" class="page mobilecontentpage">
     ...
     </div>
     ...
    </div>
   </div>
  </div>
 </div>
 ...
</body>

두 개의 div 태그가 추가되었습니다.

id가 있는 div cq-emulator 에뮬레이터를 전체로서 들고
id가 있는 div cq-emulator-content 페이지 컨텐츠가 있는 장치의 뷰포트/화면/컨텐츠 영역을 나타냅니다.

새 CSS 클래스도 새 에뮬레이터 div에 할당됩니다. 현재 에뮬레이터의 이름을 나타냅니다.

에뮬레이터의 플러그인은 현재 장치 회전에 따라 "vertical" 또는 "horizontal" 클래스를 삽입하는 순환 플러그인의 예와 같이 할당된 CSS 클래스 목록을 추가로 확장할 수 있습니다.

이렇게 하면 에뮬레이터 디브의 ID 및 CSS 클래스에 해당하는 CSS 클래스를 가지고 있으므로 에뮬레이터의 전체 모양을 제어할 수 있습니다.

NOTE

프로젝트 HTML이 위의 예와 마찬가지로 본문 컨텐츠를 단일 div로 래핑하는 것이 좋습니다. 본문 콘텐츠에 여러 태그가 포함된 경우 예기치 않은 결과가 발생할 수 있습니다.

모바일 에뮬레이터 mobile-emulators

기존 모바일 에뮬레이터:

/libs/wcm/mobile/components/에뮬레이터 아래에 있습니다.
다음 위치에서 JSON 서블릿을 통해 사용할 수 있습니다.

http://localhost:4502/bin/wcm/mobile/emulators.json

페이지 구성 요소가 모바일 페이지 구성 요소를 사용하는 경우( /libs/wcm/mobile/components/page). 에뮬레이터 기능은 다음 메커니즘을 통해 페이지에 자동으로 통합됩니다.

모바일 페이지 구성 요소 head.jsp 장치 그룹의 연결된 에뮬레이터 init 구성 요소(작성자 모드에서만)와 장치 그룹의 렌더링 CSS가 다음을 통해 포함됩니다.

deviceGroup.drawHead(pageContext);
메서드 DeviceGroup.drawHead(pageContext) 는 에뮬레이터의 init 구성 요소, 즉 를 호출합니다. init.html.jsp 에뮬레이터 구성 요소의 두 번째 매개 변수입니다. 에뮬레이터 구성 요소에 자체 구성 요소가 없는 경우 init.html.jsp 모바일 기본 에뮬레이터( wcm/mobile/components/emulators/base)를 호출할 때 모바일 기본 에뮬레이터의 init 스크립트를 /libs/wcm/mobile/components/emulators/base/init.html.jsp).
모바일 기본 에뮬레이터의 초기화 스크립트는 Javascript를 통해 정의합니다.
- 페이지에 대해 정의된 모든 에뮬레이터의 구성(에뮬레이터Configs)
- 에뮬레이터의 기능을 페이지에 통합하는 에뮬레이터 관리자:
  
  emulatorMgr.launch(config);
  
  에뮬레이터 관리자는
  
  /libs/wcm/emulator/widgets/source/EmulatorManager.js

사용자 지정 모바일 에뮬레이터 만들기 creating-a-custom-mobile-emulator

사용자 지정 모바일 에뮬레이터를 만들려면:

아래 /apps/myapp/components/emulators 구성 요소 만들기 myemulator (노드 유형: cq:Component).
설정 sling:resourceSuperType 속성 대상 /libs/wcm/mobile/components/emulators/base
카테고리가 있는 CSS 클라이언트 라이브러리 정의 cq.wcm.mobile.emulator 에뮬레이터 모양: name = css, 노드 유형 = cq:ClientLibrary

예를 들어, 노드를 참조할 수 있습니다 /libs/wcm/mobile/components/emulators/iPhone/css
필요한 경우 JS 클라이언트 라이브러리를 정의하여 특정 플러그인을 정의합니다. name = js, 노드 유형 = cq:ClientLibrary

예를 들어, 노드를 참조할 수 있습니다 /libs/wcm/mobile/components/emulators/base/js
에뮬레이터가 플러그인으로 정의된 특정 기능(터치 스크롤과 같은)을 지원하는 경우 에뮬레이터 아래에 구성 노드를 만드십시오. name = cq:emulatorConfig, 노드 유형 = nt:unstructured 플러그인을 정의하는 속성을 추가합니다.
- 이름 = canRotate, 유형 = Boolean, 값 = true: 를 클릭하여 회전 기능을 포함합니다.
- 이름 = touchScrolling, 유형 = Boolean, 값 = true: 터치 스크롤 기능을 포함하도록 업데이트되고 수정되었습니다.
고유한 플러그인을 정의하여 더 많은 기능을 추가할 수 있습니다.

recommendation-more-help

2315f3f5-cb4a-4530-9999-30c8319c520e