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

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

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

반응형 디자인 동작을 구현하는 방법은 다음 항목을 참조하십시오.

디자인할 때 사이드킥입니다 다양한 화면 크기에 대해 페이지를 미리 보려면

개발하기 전에 before-you-develop

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

응용 프로그램 구조 application-structure

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

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

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

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

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

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

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

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

의 css.txt 파일 /etc/designs/weretail/clientlibs 폴더에는 클라이언트 라이브러리 폴더에 포함하는 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

반응형 디자인의 동작을 테스트하려면 다양한 뷰포트 크기로 페이지 미리 보기 를 참조하십시오. in 미리 보기 모드, 사이드킥입니다 포함 장치 장치를 선택하는 데 사용하는 드롭다운 메뉴 장치를 선택하면 페이지가 뷰포트 크기에 맞게 변경됩니다.

에서 장치 미리 보기를 활성화하려면 사이드킥입니다 ​를 채울 때는 페이지 및 MobileEmulatorProvider 서비스. 다른 페이지 구성은 장치 목록.

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

다음 장치 목록에 표시됩니다. 사이드킥입니다 페이지에 를 렌더링하는 JSP 스크립트가 포함되어 있는 경우 장치 목록. 를 추가하려면 장치 목록 대상 사이드킥입니다, 다음 포함 /libs/wcm/mobile/components/simulator/simulator.jsp 스크립트에서 head 섹션에 자세히 설명되어 있습니다.

다음 코드를 JSP에 포함시켜 head 섹션:

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

예제를 보려면 /apps/weretail/components/page/head.jsp CRXDE Lite 파일.

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

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

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

예를 들어 [sling:OsgiConfig](/docs/experience-manager-64/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

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

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

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

무료 제공 picturefill.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>

페이지가 렌더링되면 pictureflow.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 표현물 2개 중에서 선택합니다.

<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 코드는 div JSP에서 생성하는 요소:

<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 요청을 전달합니다 http://localhost:4502/content/geometrixx/adaptiveImage.img.jpg 응용 이미지 구성 요소 서블릿으로 이동합니다.

두 개의 추가 선택기는 요청된 이미지 너비와 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 class는 extends 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 클래스는 doGet HTTP 요청을 처리하는 메서드입니다. 이 메서드는 요청과 연결된 리소스를 결정하고 저장소에서 리소스 속성을 검색하고 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 요청을 전달합니다 http://localhost:4502/content/geometrixx/en.image.jpg 이미지 참조 수정 서블릿으로 이동합니다.

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

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

지원되는 이미지 속성

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

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

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

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

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

이미지 경로, 차원 및 품질 값은 리포지토리에서 노드의 속성으로 저장해야 합니다.

페이지를 작성할 때는 사이드킥입니다 이미지를 지정하고 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 클래스는 doGet HTTP 요청을 처리하는 메서드입니다. 이 메서드는 호출과 연결된 리소스를 결정하고 저장소에서 리소스 속성을 검색하여 ImageContext 개체.

다음 ImageReferenceModificationServlet 클래스는 를 무시합니다 createLayer 렌더링할 이미지 리소스를 결정하는 논리를 구현합니다. 메서드는 페이지의 하위 노드를 검색합니다 jcr:content 노드 이름 image. An 이미지 이 개체를 사용하여 개체를 만듭니다 image 노드 및 getFileReference 메서드는 fileReference 이미지 노드의 속성입니다.

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

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

유체 그리드에 익숙하지 않다면 유체 그리드 소개 섹션에 있는 마지막 항목이 될 필요가 없습니다. 이 소개에서는 유체 그리드에 대한 개요와 이를 디자인하기 위한 지침을 제공합니다.

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

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

예를 들어 샘플 geometrixx-media 응용 프로그램에는 media-home 구성 요소가 포함되어 있습니다. 이 페이지 구성 요소는 두 개의 스크립트를 삽입하며, 이 두 개의 스크립트는 div 클래스 요소 row-fluid:

<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 클래스, span* 클래스 및 span* 하위 클래스 row-fluid 클래스를 참조하십시오. 미디어 쿼리를 사용하면 다양한 뷰포트 크기에 대해 스타일을 다시 정의할 수 있습니다.

다음 예제 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는 media-home 페이지 구성 요소가 생성하는 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. 이러한 구성 요소에는 필요에 따라 기본 페이지의 스크립트를 재정의하는 스크립트가 포함됩니다.

예를 들어 Geometrixx-media 응용 프로그램에는 페이지 구성 요소( sling:resourceSuperType 는 기초 페이지 구성 요소입니다.) 여러 하위 구성 요소(예: 문서, 카테고리 및 media-home)는 이 페이지 구성 요소를 sling:resourceSuperType. 각 하위 구성 요소에는 페이지 구성 요소의 content.jsp 파일을 무시하는 content.jsp 파일이 포함되어 있습니다.

스크립트 다시 사용

여러 페이지 구성 요소에 공통인 행 및 열 조합을 생성하는 여러 JSP 스크립트를 생성합니다. 예: content.jsp 문서 및 media-home 구성 요소의 스크립트는 모두 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>

다음 .row-fluid .span6 페이지 CSS의 선택기는 div 이 HTML에서 동일한 클래스 및 구조의 요소 그러나 구성 요소에는 /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 행의 콘텐츠 블록이 가로로 배치되는지 세로로 배치되는지를 제어하는 클래스입니다.

스타일을 .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 응용 프로그램을 사용하여 그리드를 구현할 수 있습니다.