웹 페이지를 위한 응답형 디자인 responsive-design-for-web-pages

웹 페이지가 표시되는 클라이언트 뷰포트에 맞게 조정되도록 웹 페이지를 디자인합니다. 응답형 디자인을 사용하면 동일한 페이지를 두 방향에서 여러 디바이스에 효과적으로 표시할 수 있습니다. 다음 이미지는 페이지가 뷰포트 크기의 변화에 응답할 수 있는 몇 가지 방법을 보여 줍니다.

다양한 창 크기 및 방향에 맞는 HTML5 페이지를 생성하는 Adobe Experience Manager(AEM) 애플리케이션을 개발합니다. 예를 들어, 다음 뷰포트 너비 범위는 다양한 디바이스 유형 및 방향에 해당합니다

반응형 디자인 동작 구현에 대한 자세한 내용은 다음 항목을 참조하십시오.

디자인할 때 Sidekick ​을 사용하여 다양한 화면 크기로 페이지를 미리 봅니다.

개발하기 전에 before-you-develop

웹 페이지를 지원하는 AEM 애플리케이션을 개발하기 전에 몇 가지 디자인 결정을 내려야 합니다. 예를 들어 다음 정보가 있어야 합니다.

애플리케이션 구조 application-structure

일반적인 AEM 애플리케이션 구조는 모든 응답형 디자인 구현을 지원합니다.

미디어 쿼리 사용 using-media-queries

미디어 쿼리를 사용하면 페이지 렌더링에 CSS 스타일을 선택적으로 사용할 수 있습니다. AEM 개발 도구 및 기능을 사용하면 애플리케이션에서 미디어 쿼리를 효과적이고 효율적으로 구현할 수 있습니다.

W3C 그룹은 이 CSS3 기능 및 구문을 설명하는 미디어 쿼리 권장 사항을 제공합니다.

CSS 파일 만들기 creating-the-css-file

CSS 파일에서 타겟팅하는 장치의 속성을 기반으로 미디어 쿼리를 정의합니다. 다음 구현 전략은 각 미디어 쿼리의 스타일을 관리하는 데 효과적입니다.

We.Retail 미디어 샘플은 이 전략을 사용하여 사이트 디자인에 스타일을 정의합니다. We.Retail에서 사용하는 CSS 파일이 */apps/weretail/clientlibs/clientlib-site/less/grid.less에 있습니다.

다음 표에는 css 하위 폴더의 파일이 나열되어 있습니다.

/etc/designs/weretail/clientlibs 폴더의 css.txt 파일에 클라이언트 라이브러리 폴더에 포함된 CSS 파일이 나열됩니다. 파일의 순서는 스타일 우선 순위를 구현합니다. 장치 크기가 줄어들면 스타일이 더 구체화됩니다.

#base=css

style.css
 bootstrap.css

responsive-1200px.css
 responsive-980px-1199px.css
 responsive-768px-979px.css
 responsive-767px-max.css
 responsive-480px.css

팁: 설명 파일 이름을 사용하면 대상 뷰포트 크기를 쉽게 식별할 수 있습니다.

AEM 페이지에서 미디어 쿼리 사용 using-media-queries-with-aem-pages

페이지 구성 요소의 JSP 스크립트에 클라이언트 라이브러리 폴더를 포함합니다. 이렇게 하면 미디어 쿼리를 포함하고 파일을 참조하는 CSS 파일을 생성하는 데 도움이 됩니다.

<ui:includeClientLib categories="apps.weretail.all"/>

JSP 스크립트는 스타일 시트를 참조하는 다음 HTML 코드를 생성합니다.

<link rel="stylesheet" href="/etc/designs/weretail/clientlibs-all.css" type="text/css">
<link href="/etc/designs/weretail.css" rel="stylesheet" type="text/css">

특정 장치에 대한 미리 보기 previewing-for-specific-devices

반응형 디자인의 동작을 테스트할 수 있도록 다양한 뷰포트 크기로 페이지 미리보기 를 참조하십시오. 미리 보기 모드에서 Sidekick ​에는 장치를 선택하는 데 사용하는 장치 드롭다운 메뉴가 포함되어 있습니다. 장치를 선택하면 페이지가 뷰포트 크기에 맞게 변경됩니다.

Sidekick ​에서 장치 미리 보기를 사용하려면 페이지와 MobileEmulatorProvider 서비스를 구성해야 합니다. 다른 페이지 구성은 장치 목록에 나타나는 장치 목록을 제어합니다.

장치 목록 추가 adding-the-devices-list

페이지에 장치 목록을 렌더링하는 JSP 스크립트가 포함된 경우 장치 목록이 Sidekick ​에 나타납니다. 장치 목록을 Sidekick ​에 추가하려면 페이지의 head 섹션에 /libs/wcm/mobile/components/simulator/simulator.jsp 스크립트를 포함하십시오.

head 섹션을 정의하는 JSP에 다음 코드를 포함하십시오.

<cq:include script="/libs/wcm/mobile/components/simulator/simulator.jsp"/>

예제를 보려면 CRXDE Lite에서 /apps/weretail/components/page/head.jsp 파일을 여십시오.

시뮬레이션을 위한 페이지 구성 요소 등록 registering-page-components-for-simulation

장치 시뮬레이터가 페이지를 지원하도록 하려면 페이지 구성 요소를 MobileEmulatorProvider 팩토리 서비스에 등록하고 mobile.resourceTypes 속성을 정의합니다.

AEM을 사용하여 작업할 때 이러한 서비스에 대한 구성 설정을 관리할 수 있는 방법에는 몇 가지가 있습니다. 자세한 내용은 OSGi 구성을 참조하십시오.

예를 들어 응용 프로그램에서 [sling:OsgiConfig](/docs/experience-manager-65/content/implementing/deploying/configuring/configuring-osgi.md#adding-a-new-configuration-to-the-repository) 노드를 만들려면 다음 작업을 수행하십시오.

다음 노드 속성을 추가합니다.

장치 그룹 지정 specifying-the-device-groups

장치 목록에 표시되는 장치 그룹을 지정하려면 cq:deviceGroups 속성을 사이트의 루트 페이지에 있는 jcr:content 노드에 추가하십시오. 속성 값은 장치 그룹 노드에 대한 경로 배열입니다.

장치 그룹 노드가 /etc/mobile/groups 폴더에 있습니다.

예를 들어 Geometrixx Media 사이트의 루트 페이지는 /content/geometrixx-media입니다. /content/geometrixx-media/jcr:content 노드에는 다음 속성이 포함되어 있습니다.

도구 콘솔을 사용하여 장치 그룹을 만들고 편집하세요.

적응형 이미지 사용 using-adaptive-images

미디어 쿼리를 사용하여 페이지에 표시할 이미지 리소스를 선택할 수 있습니다. 단, 미디어 쿼리를 사용하여 사용을 조건화하는 모든 리소스는 클라이언트에 다운로드됩니다. 미디어 쿼리는 다운로드한 리소스가 표시되는지 여부만 결정합니다.

이미지와 같은 대규모 리소스의 경우 모든 리소스를 다운로드하는 것은 클라이언트의 데이터 파이프라인을 효율적으로 사용하는 것이 아닙니다. 리소스를 선택적으로 다운로드하려면 미디어 쿼리가 선택을 수행한 후 JavaScript을 사용하여 리소스 요청을 시작합니다.

다음 전략은 미디어 쿼리를 사용하여 선택된 단일 리소스를 로드합니다.

JavaScript을 사용하여 미디어 쿼리 평가 evaluating-media-queries-using-javascript

W3C가 정의하는 MediaQueryList 인터페이스의 구현을 사용하면 JavaScript을 사용하여 미디어 쿼리를 평가할 수 있습니다. 미디어 쿼리 결과에 논리를 적용하고 현재 창에 대해 타겟팅된 스크립트를 실행할 수 있습니다.

미디어별 리소스 선택 selecting-media-specific-resources

W3C 그림 요소는 미디어 쿼리를 사용하여 이미지 요소에 사용할 원본을 결정합니다. 그림 요소는 요소 특성을 사용하여 미디어 쿼리를 이미지 경로와 연결합니다.

자유롭게 사용할 수 있는 picturepe.js 라이브러리는 제안된 picture 요소와 유사한 기능을 제공하며 유사한 전략을 사용합니다. picturefill.js 라이브러리는 window.matchMedia을 호출하여 div 요소 집합에 대해 정의된 미디어 쿼리를 평가합니다. 각 div 요소는 이미지 소스도 지정합니다. div 요소의 미디어 쿼리가 true을(를) 반환하는 경우 원본이 사용됩니다.

picturefill.js 라이브러리에는 다음 예제와 유사한 HTML 코드가 필요합니다.

<div data-picture>
    <div data-src='path to default image'></div>
    <div data-src='path to small image'    data-media="(media query for phone)"></div>
    <div data-src='path to medium image'   data-media="(media query for tablet)"></div>
    <div data-src='path to large image'     data-media="(media query for monitor)"></div>
</div>

페이지가 렌더링되면 pictureull.js는 img 요소를 <div data-picture> 요소의 마지막 자식으로 삽입합니다.

<div data-picture>
    <div data-src='path to default image'></div>
    <div data-src='path to small image'    data-media="(media query for phone)"></div>
    <div data-src='path to medium image'   data-media="(media query for tablet)"></div>
    <div data-src='path to large image'     data-media="(media query for monitor)"></div>
    <img src="path to medium image">
</div>

AEM 페이지에서 data-src 특성의 값은 저장소의 리소스에 대한 경로입니다.

AEM에서 적응형 이미지 구현 implementing-adaptive-images-in-aem

AEM 애플리케이션에서 적응형 이미지를 구현하려면 필요한 JavaScript 라이브러리를 추가하고 페이지에 필요한 HTML 마크업을 포함해야 합니다.

라이브러리

다음 JavaScript 라이브러리를 가져와 클라이언트 라이브러리 폴더에 포함합니다.

팁: 포함하여 여러 클라이언트 라이브러리 폴더를 자동으로 연결할 수 있습니다.

HTML

picturefill.js 코드에 필요한 div 요소를 생성하는 구성 요소를 만듭니다. AEM 페이지에서 data-src 속성의 값은 저장소의 리소스에 대한 경로입니다. 예를 들어 페이지 구성 요소는 DAM에서 이미지 표현물에 대한 미디어 쿼리와 관련 경로를 하드 코딩할 수 있습니다. 또는 작성자가 이미지 표현물을 선택하거나 런타임 렌더링 옵션을 지정할 수 있는 사용자 지정 이미지 구성 요소를 만듭니다.

다음 예제 HTML은 동일한 이미지의 두 DAM 표현물을 선택합니다.

<div data-picture>
    <div data-src='/content/dam/geometrixx-media/articles/meridien.png'></div>
    <div data-src='/content/dam/geometrixx-media/articles/meridien.png/jcr:content/renditions/cq5dam.thumbnail.319.319.png'    data-media="(min-width: 769px)"></div>
    <div data-src='/content/dam/geometrixx-media/articles/meridien.png/jcr:content/renditions/cq5dam.thumbnail.140.100.png'   data-media="(min-width: 481px)"></div>
</div>

AEM의 이미지 렌더링 이해 understanding-image-rendering-in-aem

이미지 렌더링을 사용자 지정하려면 기본 AEM 정적 이미지 렌더링 구현을 이해해야 합니다. AEM은 웹 페이지에 대한 이미지를 렌더링하기 위해 함께 작동하는 이미지 구성 요소와 이미지 렌더링 서블릿을 제공합니다. 이미지 구성 요소가 페이지의 단락 시스템에 포함되면 다음 이벤트 시퀀스가 발생합니다.

예를 들어 이미지 구성 요소의 JSP는 다음 HTML 요소를 생성합니다.

<img title="My Image" alt="My Image" class="cq-dd-image" src="/content/mywebsite/en/_jcr_content/par/image_0.img.jpg/1358372073597.jpg">

브라우저가 페이지를 로드하면 src 속성의 값을 URL로 사용하여 이미지를 요청합니다. Sling은 URL을 분해합니다.

image_0 노드의 jcr:resourceType 값은 foundation/components/image이고, sling:resourceSuperType 값은 foundation/components/parbase입니다. parbase 구성 요소에는 선택기와 요청 URL의 파일 이름 확장자가 일치하는 img.GET.java 스크립트가 포함됩니다. CQ는 이 스크립트(서블릿)를 사용하여 이미지를 렌더링합니다.

스크립트의 소스 코드를 보려면 CRXDE Lite을 사용하여 /libs/foundation/components/parbase/img.GET.java을(를) 엽니다.
파일.

현재 뷰포트 크기에 대한 이미지 크기 조절 scaling-images-for-the-current-viewport-size

클라이언트 뷰포트의 특성에 따라 런타임에 이미지의 비율을 조정하여 반응형 디자인의 원칙에 부합하는 이미지를 제공합니다. 서블릿 및 작성 구성 요소를 사용하여 정적 이미지 렌더링과 동일한 디자인 패턴을 사용합니다.

구성 요소는 다음 작업을 수행해야 합니다.

이미지 요청을 처리하는 서블릿은 다음 작업을 수행해야 합니다.

사용 가능한 솔루션

AEM은 사용하거나 확장할 수 있는 다음 구현을 설치합니다.

응용 이미지 구성 요소 이해 understanding-the-adaptive-image-component

적응형 이미지 구성 요소는 디바이스 화면에 따라 크기가 조정된 이미지를 렌더링하기 위해 적응형 이미지 구성 요소 서블릿에 대한 호출을 생성합니다. 구성 요소에는 다음 리소스가 포함됩니다.

DIV 요소 추가 adding-the-div-elements

adaptive-image.jsp 스크립트에는 div 요소 및 미디어 쿼리를 생성하는 다음 코드가 포함됩니다.

<div data-picture data-alt='<%= alt %>'>
    <div data-src='<%= path + ".img.320.low." + extension + suffix %>'       data-media="(min-width: 1px)"></div>                                        <%-- Small mobile --%>
    <div data-src='<%= path + ".img.320.medium." + extension + suffix %>'    data-media="(min-width: 320px)"></div>  <%-- Portrait mobile --%>
    <div data-src='<%= path + ".img.480.medium." + extension + suffix %>'    data-media="(min-width: 321px)"></div>  <%-- Landscape mobile --%>
    <div data-src='<%= path + ".img.476.high." + extension + suffix %>'      data-media="(min-width: 481px)"></div>   <%-- Portrait iPad --%>
    <div data-src='<%= path + ".img.620.high." + extension + suffix %>'      data-media="(min-width: 769px)"></div>  <%-- Landscape iPad --%>
    <div data-src='<%= path + ".img.full.high." + extension + suffix %>'     data-media="(min-width: 1025px)"></div> <%-- Desktop --%>

    <%-- Fallback content for non-JS browsers. Same img src as the initial, unqualified source element. --%>
    <noscript>
        <img src='<%= path + ".img.320.low." + extension + suffix %>' alt='<%= alt %>'>
    </noscript>
</div>

path 변수에 현재 리소스(응용 이미지 구성 요소 노드)의 경로가 포함되어 있습니다. 이 코드는 다음 구조를 가진 일련의 div 요소를 생성합니다.

<div data-scr = "*path-to-parent-node*.adaptive-image.adapt.*width*.*quality*.jpg" data-media="*media query*"></div>

data-scr 특성 값은 Sling이 이미지를 렌더링하는 적응형 이미지 구성 요소 서블릿으로 확인되는 URL입니다. data-media 속성에는 클라이언트 속성에 대해 평가되는 미디어 쿼리가 포함됩니다.

다음 HTML 코드는 JSP가 생성하는 div 요소의 예입니다.

<div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.320.low.jpg'></div>
    <div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.320.medium.jpg'    data-media="(min-width: 320px)"></div>
    <div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.480.medium.jpg'    data-media="(min-width: 321px)"></div>
    <div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.476.high.jpg'     data-media="(min-width: 481px)"></div>
    <div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.620.high.jpg'     data-media="(min-width: 769px)"></div>
    <div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.full.high.jpg'     data-media="(min-width: 1025px)"></div>

이미지 크기 선택기 변경 changing-the-image-size-selectors

적응형 이미지 구성 요소를 사용자 정의하고 너비 선택기를 변경하는 경우 너비를 지원하도록 적응형 이미지 구성 요소 서블릿 을 구성해야 합니다.

적응형 이미지 구성 요소 서블릿 이해 understanding-the-adaptive-image-component-servlet

적응형 이미지 구성 요소 서블릿은 지정된 너비에 따라 JPEG 이미지 크기를 조정하고 JPEG 품질을 설정합니다.

적응형 이미지 구성 요소 서블릿의 인터페이스 the-interface-of-the-adaptive-image-component-servlet

적응형 이미지 구성 요소 서블릿은 기본 Sling 서블릿에 바인딩되며 .jpg, .jpeg, .gif 및 .png 파일 확장명을 지원합니다. 서블릿 선택기가 img입니다.

따라서 Sling은 다음 형식의 HTTP 요청 URL을 이 서블릿으로 확인합니다.

*path-to-node*.img.*extension*

예를 들어 Sling은 URL이 http://localhost:4502/content/geometrixx/adaptiveImage.img.jpg인 HTTP 요청을 적응형 이미지 구성 요소 서블릿에 전달합니다.

두 개의 추가 선택기는 요청된 이미지 폭과 JPEG 품질을 지정합니다. 다음 예제에서는 너비가 480픽셀이고 중간 품질인 이미지를 요청합니다.

http://localhost:4502/content/geometrixx/adaptiveImage.adapt.480.MEDIUM.jpg

지원되는 이미지 속성

서블릿은 유한한 수의 이미지 폭과 품질을 허용합니다. 다음 너비는 기본적으로 지원됩니다(픽셀 단위).

전체 값은 배율이 없음을 나타냅니다.

JPEG 품질에 대한 다음 값이 지원됩니다.

숫자 값은 각각 0.4, 0.82 및 1.0입니다.

지원되는 기본 너비 변경

웹 콘솔(http://localhost:4502/system/console/configMgr) 또는 sling:OsgiConfig 노드를 사용하여 Adobe CQ 적응형 이미지 구성 요소 서블릿의 지원되는 폭을 구성합니다.

AEM 서비스를 구성하는 방법에 대한 자세한 내용은 OSGi 구성을 참조하십시오.

구현 세부 사항 implementation-details

com.day.cq.wcm.foundation.impl.AdaptiveImageComponentServlet 클래스는 AbstractImageServlet 클래스를 확장합니다. AdaptiveImageComponentServlet 소스 코드가 /libs/foundation/src/impl/src/com/day/cq/wcm/foundation/impl 폴더에 있습니다.

이 클래스는 Felix SCR 주석을 사용하여 서블릿이 연결되는 리소스 유형 및 파일 확장자와 첫 번째 선택기의 이름을 구성합니다.

@Component(metatype = true, label = "Adobe CQ Adaptive Image Component Servlet",
        description = "Render adaptive images in a variety of qualities")
@Service
@Properties(value = {
    @Property(name = "sling.servlet.resourceTypes", value = "foundation/components/adaptiveimage", propertyPrivate = true),
    @Property(name = "sling.servlet.selectors", value = "img", propertyPrivate = true),
    @Property(name = "sling.servlet.extensions", value ={
            "jpg",
            "jpeg",
            "png",
            "gif"
    }, propertyPrivate = true)
})

서블릿은 속성 SCR 주석을 사용하여 지원되는 기본 이미지 품질 및 차원을 설정합니다.

@Property(value = {
            "320", // iPhone portrait
            "480", // iPhone landscape
            "476", // iPad portrait
            "620" // iPad landscape
    },
            label = "Supported Widths",
            description = "List of widths this component is permitted to generate.")

AbstractImageServlet 클래스는 HTTP 요청을 처리하는 doGet 메서드를 제공합니다. 이 메서드는 요청과 연결된 리소스를 확인하고 저장소에서 리소스 속성을 검색하여 ImageContext 개체에 반환합니다.

AdaptiveImageComponentServlet 클래스는 createLayer 메서드를 재정의합니다. 메서드는 ImageContext 개체에서 이미지 리소스의 경로와 요청된 이미지 너비를 가져옵니다. 그런 다음 실제 이미지 크기 조절을 수행하는 info.geometrixx.commons.impl.AdaptiveImageHelper 클래스의 메서드를 호출합니다.

AdaptiveImageComponentServlet 클래스도 writeLayer 메서드를 재정의합니다. 이 메서드는 이미지에 JPEG 품질을 적용합니다.

이미지 참조 수정 서블릿(Geometrixx 공통) image-reference-modification-servlet-geometrixx-common

샘플 이미지 참조 수정 서블릿은 웹 페이지에서 이미지 크기를 조정할 img 요소에 대한 크기 속성을 생성합니다.

서블릿 호출 calling-the-servlet

서블릿은 cq:page 리소스에 바인딩되며 .jpg 파일 확장명을 지원합니다. 서블릿 선택기는 image입니다. 따라서 Sling은 다음 형식의 HTTP 요청 URL을 이 서블릿으로 확인합니다.

path-to-page-node.image.jpg

예를 들어 Sling은 URL이 http://localhost:4502/content/geometrixx/en.image.jpg인 HTTP 요청을 이미지 참조 수정 서블릿에 전달합니다.

세 개의 추가 선택기는 요청된 이미지 너비, 높이 및 (선택적으로) 품질을 지정합니다. 다음 예제에서는 폭 770픽셀, 높이 360픽셀, 중간 품질의 이미지를 요청합니다.

http://localhost:4502/content/geometrixx/en.image.770.360.MEDIUM.jpg

지원되는 이미지 속성

서블릿은 한정된 수의 이미지 차원과 품질 값을 허용합니다.

기본적으로 다음 값이 지원됩니다(widthxheight).

이미지 품질에 대해 다음 값이 지원됩니다.

AEM을 사용하여 작업할 때 이러한 서비스에 대한 구성 설정을 관리할 수 있는 방법에는 몇 가지가 있습니다. 자세한 내용은 OSGi 구성을 참조하십시오.

이미지 리소스 지정 specifying-the-image-resource

이미지 경로, 치수 및 품질 값은 저장소의 노드 속성으로 저장해야 합니다.

페이지를 작성할 때 Sidekick ​을(를) 사용하여 이미지를 지정하고 image 노드를 페이지 속성에 추가하십시오.

구현 세부 사항 implementation-details-1

info.geometrixx.commons.impl.servlets.ImageReferenceModificationServlet 클래스는 AbstractImageServlet 클래스를 확장합니다. cq-geometrixx-commons-pkg 패키지가 설치되어 있는 경우 ImageReferenceModificationServlet 소스 코드는 /apps/geometrixx-commons/src/core/src/main/java/info/geometrixx/commons/impl/servlets 폴더에 있습니다.

이 클래스는 Felix SCR 주석을 사용하여 서블릿이 연결되는 리소스 유형 및 파일 확장자와 첫 번째 선택기의 이름을 구성합니다.

@Component(metatype = true, label = "Adobe CQ Image Reference Modification Servlet",
        description = "Render the image associated with a page in a variety of dimensions and qualities")
@Service
@Properties(value = {
    @Property(name = "sling.servlet.resourceTypes", value = NameConstants.NT_PAGE, propertyPrivate = true),
    @Property(name = "sling.servlet.selectors", value = "image", propertyPrivate = true),
    @Property(name = "sling.servlet.extensions", value = "jpg", propertyPrivate = true)
})

서블릿은 속성 SCR 주석을 사용하여 지원되는 기본 이미지 품질 및 차원을 설정합니다.

@Property(label = "Image Quality",
            description = "Quality must be a double between 0.0 and 1.0", value = "0.82")
@Property(value = {
                "256x192", // Category page article list images
                "370x150", // "Most popular" desktop & iPad & carousel min-width: 1px
                "480x200", // "Most popular" phone
                "127x127", // article summary phone square images
                "770x360", // article summary, desktop
                "620x290", // article summary, tablet
                "480x225", // article summary, phone (landscape)
                "320x150", // article summary, phone (portrait) and fallback
                "375x175", // 2-column article summary, desktop
                "303x142", // 2-column article summary, tablet
                "1170x400", // carousel, full
                "940x340",  // carousel min-width: 980px
                "770x300",  // carousel min-width: 768px
                "480x190"   // carousel min-width: 480px
            },
            label = "Supported Resolutions",
            description = "List of resolutions this component is permitted to generate.")

AbstractImageServlet 클래스는 HTTP 요청을 처리하는 doGet 메서드를 제공합니다. 이 메서드는 호출과 연결된 리소스를 확인하고 저장소에서 리소스 속성을 검색하여 ImageContext 개체에 저장합니다.

ImageReferenceModificationServlet 클래스는 createLayer 메서드를 재정의하고 렌더링할 이미지 리소스를 결정하는 논리를 구현합니다. 메서드는 이름이 image인 페이지의 jcr:content 노드의 자식 노드를 검색합니다. 이 image 노드에서 Image 개체가 만들어지고 getFileReference 메서드가 이미지 노드의 fileReference 속성에서 이미지 파일에 대한 경로를 반환합니다.

유체 그리드 개발 developing-a-fluid-grid

AEM을 사용하면 유체 그리드를 효율적이고 효과적으로 구현할 수 있습니다. 이 페이지에서는 Fluid Grid 또는 기존 Grid 구현(예: Bootstrap)을 AEM 응용 프로그램에 통합하는 방법을 설명합니다.

유체 그리드에 익숙하지 않은 경우 이 페이지 하단에 있는 유체 그리드 소개 섹션을 참조하십시오. 이 소개에서는 유체 격자의 개요와 유체 격자를 설계하기 위한 지침을 제공합니다.

페이지 구성 요소를 사용하여 그리드 정의 defining-the-grid-using-a-page-component

페이지 구성 요소를 사용하여 페이지의 콘텐츠 블록을 정의하는 HTML 요소를 생성합니다. 페이지가 참조하는 ClientLibraryFolder는 콘텐츠 블록의 레이아웃을 제어하는 CSS를 제공합니다.

예를 들어 샘플 geometrixx-media 애플리케이션에는 media-home 구성 요소가 포함되어 있습니다. 이 페이지 구성 요소는 두 개의 스크립트를 삽입하고 row-fluid 클래스의 두 div 요소를 생성합니다.

<div class="page-content">
    <div class="row-fluid">
        <div class="span12">
            <cq:include path="grid-12-par" resourceType="foundation/components/parsys" />
        </div>
    </div>
    <div class="row-fluid">
        <div class="span8">
            <cq:include path="grid-8-par" resourceType="foundation/components/parsys" />
        </div>
        <div class="span4">
            <cq:include path="grid-4-par" resourceType="foundation/components/parsys" />
        </div>
    </div>
</div>

페이지 구성 요소 격자 크기 조절 scaling-the-page-component-grid

geometrixx-media 페이지 구성 요소(/etc/designs/geometrixx-media)와 연결된 디자인에 clientlibs ClientLibraryFolder가 포함되어 있습니다. 이 ClientLibraryFolder는 row-fluid 클래스의 하위 클래스인 row-fluid 클래스, span* 클래스 및 span* 클래스의 CSS 스타일을 정의합니다. 미디어 쿼리를 사용하면 다양한 뷰포트 크기에 대해 스타일을 다시 정의할 수 있습니다.

다음 예제 CSS는 이러한 스타일의 하위 집합입니다. 이 하위 집합은 span12, span8 및 span4 클래스와 두 뷰포트 크기에 대한 미디어 쿼리에 중점을 둡니다. CSS의 다음 특성에 주목하십시오.

/* default styles (no media queries) */
 .span12 { width: 940px }
 .span8 { width: 620px }
 .span4 { width: 300px }
 .row-fluid .span12 { width: 100% }
 .row-fluid .span8 { width: 65.95744680851064% }
 .row-fluid .span4 { width: 31.914893617021278% }

@media (min-width: 768px) and (max-width: 979px) {
 .span12 { width: 724px; }
 .span8 {     width: 476px; }
 .span4 {     width: 228px; }
 .row-fluid .span12 {     width: 100%;}
 .row-fluid .span8 {     width: 65.74585635359117%; }
 .row-fluid .span4 {     width: 31.491712707182323%; }
}

@media (min-width: 1200px) {
 .span12 { width: 1170px }
 .span8 { width: 770px }
 .span4 { width: 370px }
 .row-fluid .span12 { width: 100% }
 .row-fluid .span8 { width: 65.81196581196582% }
 .row-fluid .span4 { width: 31.623931623931625% }
}

페이지 구성 요소 그리드에서 컨텐츠 위치 변경 repositioning-content-in-the-page-component-grid

샘플 Geometrixx Media 애플리케이션의 페이지는 콘텐츠 블록의 행을 넓은 뷰포트에 수평으로 분배합니다. 더 작은 뷰포트에서는 동일한 블록이 수직으로 분산됩니다. 다음 예제 CSS는 미디어 홈 페이지 구성 요소가 생성하는 HTML 코드에 대해 이 동작을 구현하는 스타일을 보여 줍니다.

/* default styles (no media queries) */
    .row-fluid [class*="span"] {
        width: 100%;
        float: left;
}

@media (max-width: 767px) {
    [class*="span"], .row-fluid [class*="span"] {
        float: none;
        width: 100%;
    }
}

페이지 구성 요소 모듈화 tip-modularize-your-page-components

코드를 효율적으로 사용할 수 있도록 구성 요소를 모듈화합니다. 사이트에서는 시작 페이지, 문서 페이지 또는 제품 페이지와 같은 몇 가지 유형의 페이지를 사용할 수 있습니다. 각 페이지 유형에는 서로 다른 유형의 콘텐츠가 포함되어 있으며 서로 다른 레이아웃을 사용할 수 있습니다. 그러나 각 레이아웃의 특정 요소가 여러 페이지에서 공통되는 경우 레이아웃의 해당 부분을 구현하는 코드를 다시 사용할 수 있습니다.

페이지 구성 요소 오버레이 사용

본문에서 head 및 body 섹션, header, content 및 footer 섹션 등 페이지의 다양한 부분을 생성하는 스크립트를 제공하는 기본 페이지 구성 요소를 만듭니다.

기본 페이지 구성 요소를 cq:resourceSuperType(으)로 사용하는 다른 페이지 구성 요소를 만듭니다. 이러한 구성 요소에는 필요에 따라 기본 페이지의 스크립트를 재정의하는 스크립트가 포함됩니다.

예를 들어, goemetrixx-media 응용 프로그램에는 페이지 구성 요소가 포함됩니다(sling:resourceSuperType은(는) 기본 페이지 구성 요소입니다). 문서, 범주 및 Media-home과 같은 여러 하위 구성 요소는 이 페이지 구성 요소를 sling:resourceSuperType(으)로 사용합니다. 각 하위 구성 요소에는 페이지 구성 요소의 content.jsp 파일을 무시하는 content.jsp 파일이 포함됩니다.

스크립트 재사용

여러 페이지 구성 요소에 대해 공통적인 행 및 열 조합을 생성하는 여러 JSP 스크립트를 생성합니다. 예를 들어 아티클 및 media-home 구성 요소의 content.jsp 스크립트는 모두 8x4col.jsp 스크립트를 참조합니다.

대상 뷰포트 크기별로 CSS 스타일 구성

서로 다른 뷰포트 크기에 대한 CSS 스타일과 미디어 쿼리를 별도의 파일에 포함합니다. 클라이언트 라이브러리 폴더를 사용하여 연결합니다.

페이지 그리드에 구성 요소 삽입 inserting-components-into-the-page-grid

구성 요소가 단일 콘텐츠 블록을 생성할 때 일반적으로 페이지 구성 요소가 설정하는 그리드는 콘텐츠의 배치를 제어합니다.

작성자는 콘텐츠 블록을 다양한 크기 및 상대적 위치로 렌더링할 수 있습니다. 컨텐츠 텍스트는 다른 컨텐츠 블록을 참조하는 데 상대 방향을 사용하지 않아야 합니다.

필요한 경우 구성 요소는 생성하는 HTML 코드에 필요한 CSS 또는 JavaScript 라이브러리를 제공해야 합니다. CSS 및 JS 파일이 생성되도록 구성 요소 내에 클라이언트 라이브러리 폴더를 사용하십시오. 파일을 노출하려면 /etc 폴더 아래의 다른 클라이언트 라이브러리 폴더에 종속성을 만들거나 라이브러리를 포함합니다.

하위 표

구성 요소에 여러 개의 콘텐츠 블록이 포함된 경우 행 내에 콘텐츠 블록을 추가하여 페이지의 하위 그리드를 설정합니다.

예를 들어 /apps/geometrixx-media/components/2-col-article-summary 구성 요소는 두 개의 콘텐츠 열을 생성합니다. 이 HTML이 생성하는 구조는 다음과 같습니다.

<div class="row-fluid mutli-col-article-summary">
    <div class="span6">
        <article>
            <div class="article-summary-image">...</div>
            <div class="social-header">...</div>
            <div class="article-summary-description">...</div>
            <div class="social">...</div>
        </article>
    </div>
</div>

HTML CSS의 .row-fluid .span6 선택기는 이 페이지의 동일한 클래스 및 구조의 div 요소에 적용됩니다. 그러나 구성 요소에는 /apps/geometrixx-media/components/2-col-article-summary/clientlibs 클라이언트 라이브러리 폴더도 포함됩니다.

예를 들어 /apps/geometrixx-media/components/2-col-article-summary/clientlibs/css/responsive-480px.css 파일에는 다음 스타일이 포함되어 있습니다.

@media (max-width: 480px) {
    .mutli-col-article-summary .article-summary-image {
        float: left;
        width: 127px;
    }
    .mutli-col-article-summary .article-summary-description {
        width: auto;
        margin-left: 127px;
    }
    .mutli-col-article-summary .article-summary-description h4 {
        padding-left: 10px;
    }
    .mutli-col-article-summary .article-summary-text {
        margin-left: 127px;
        min-height: 122px;
        top: 0;
    }
}

유동 격자 소개 introduction-to-fluid-grids

유동 격자를 사용하면 페이지 레이아웃을 클라이언트 뷰포트의 크기에 맞게 조정할 수 있습니다. 그리드는 페이지에 콘텐츠 블록을 배치하는 논리적 열과 행으로 구성됩니다.

HTML5 기술을 사용하여 그리드를 구현하고 이를 조작하여 페이지 레이아웃을 다양한 뷰포트 크기로 조정할 수 있습니다.

개별 폭 사용 using-discrete-widths

타겟팅하는 각 뷰포트 폭 범위에 대해 정적 페이지 폭과 일정한 폭의 콘텐츠 블록을 사용합니다. 브라우저 창의 크기를 수동으로 조정할 때, 컨텐츠 크기 변경은 개별 창 너비(중단점이라고도 함)에서 발생합니다. 따라서, 페이지 디자인은 더욱 밀착되어, 사용자 경험을 최대화한다.

격자 크기 조절 scaling-the-grid

그리드를 사용하여 콘텐츠 블록의 크기를 다른 뷰포트 크기에 맞게 조정합니다. 콘텐츠 블록은 특정 수의 열에 걸쳐 있습니다. 서로 다른 뷰포트 크기에 맞게 열 너비가 증가 또는 감소하면 콘텐츠 블록의 너비도 그에 따라 증가 또는 감소합니다. 크기를 조정하면 콘텐츠 블록의 병렬 배치를 수용할 수 있을 만큼 넓은 대형 및 중간 크기의 뷰포트를 모두 지원할 수 있습니다.

그리드에서 컨텐츠 위치 변경 repositioning-content-in-the-grid

콘텐츠 블록의 크기는 최소 너비에 의해 제한될 수 있으며, 이를 초과하는 스케일링은 더 이상 효과적이지 않다. 작은 뷰포트의 경우 격자를 사용하여 콘텐츠 블록을 가로가 아닌 세로로 배포할 수 있습니다.

격자 디자인 designing-the-grid

페이지에 콘텐츠 블록을 배치해야 하는 열과 행을 결정합니다. 페이지 레이아웃은 격자에 걸쳐 있는 열과 행의 수를 결정합니다.

열 수

모든 뷰포트 크기에 대해 모든 레이아웃에서 컨텐츠 블록을 수평으로 배치하기에 충분한 열을 포함합니다. 향후 페이지 디자인을 수용할 수 있도록 현재 필요한 것보다 더 많은 열을 사용하십시오.

행 내용

행을 사용하여 콘텐츠 블록의 세로 위치를 제어합니다. 동일한 행을 공유하는 콘텐츠 블록을 결정합니다.

그리드 구현 grid-implementations

페이지에서 콘텐츠 블록의 레이아웃을 제어할 수 있도록 CSS 클래스와 스타일을 만듭니다. 페이지 디자인은 종종 뷰포트 내의 콘텐츠 블록의 상대적 크기와 위치를 기반으로 합니다. 뷰포트는 콘텐츠 블록의 실제 크기를 결정합니다. CSS는 상대 크기와 절대 크기를 고려해야 합니다. 다음 세 가지 유형의 CSS 클래스를 사용하여 유동 격자를 구현할 수 있습니다.

타깃팅된 뷰포트 폭(및 관련 미디어 쿼리)은 페이지 레이아웃에 사용되는 개별 폭을 분리합니다.

콘텐츠 블록의 너비 widths-of-content-blocks

일반적으로 width 스타일의 콘텐츠 블록 클래스는 페이지 및 그리드의 다음 특성을 기반으로 합니다.

CSS에는 다음 구조를 사용하는 일련의 미디어 쿼리가 포함되어 있습니다.

@media(query_for_targeted_viewport){

  .class_for_container{ width:absolute_page_width }
  .class_for_row { width:100%}

  /* several selectors for content blocks   */
  .class_for_content_block1 { width:absolute_block_width1 }
  .class_for_content_block2 { width:absolute_block_width2 }
  ...

  /* several selectors for content blocks inside rows */
  .class_for_row .class_for_content_block1 { width:relative_block_width1 }
  .class_for_row .class_for_content_block2 { width:relative_block_width2 }
  ...
}

페이지의 요소 클래스 및 CSS 스타일을 개발하기 위한 시작점으로 다음 알고리즘을 사용하십시오.

행에서 콘텐츠 블록 위치 지정 positioning-content-blocks-in-rows

.row-fluid 클래스의 float 스타일을 사용하면 한 행에 있는 콘텐츠 블록을 가로로 배열할지 세로로 배열할지를 제어할 수 있습니다.

각 미디어 쿼리 내의 .row-fluid 선택기에 스타일을 추가합니다. 해당 미디어 쿼리에 사용하는 페이지 레이아웃에 따라 값을 설정합니다. 예를 들어 다음 다이어그램은 넓은 뷰포트의 경우 가로, 좁은 뷰포트의 경우 세로 방향으로 컨텐츠를 배포하는 행을 보여 줍니다.

다음 CSS는 이 동작을 구현할 수 있습니다.

@media (min-width: 768px) and (max-width: 979px) {
   .row-fluid {
       width:100%;
       float:left
   }
}

@media (max-width:480px){
    .row-fluid {
       width:100%;
       float:none
   }
}

콘텐츠 블록에 클래스 할당 assigning-classes-to-content-blocks

타깃팅하는 각 뷰포트 크기의 페이지 레이아웃에 대해 각 콘텐츠 블록이 걸쳐 있는 열의 수를 결정합니다. 그런 다음 해당 콘텐츠 블록의 div 요소에 사용할 클래스를 결정합니다.

div 클래스를 설정한 경우 AEM 애플리케이션을 사용하여 그리드를 구현할 수 있습니다.