Responsief ontwerp voor webpagina's responsive-design-for-web-pages

Ontwerp uw webpagina's zodanig dat ze zich aanpassen aan de clientviewport waarin ze worden weergegeven. Met responsief ontwerp kunnen dezelfde pagina's effectief op meerdere apparaten in beide richtingen worden weergegeven. In de volgende afbeelding ziet u enkele manieren waarop een pagina kan reageren op wijzigingen in de viewportgrootte:

Ontwikkel Adobe Experience Manager (AEM) toepassingen die HTML5 pagina's produceren die zich aan veelvoudige venstergrootte en richtlijn aanpassen. De volgende bereiken van viewport-breedten komen bijvoorbeeld overeen met verschillende apparaattypen en -oriëntaties

Zie de volgende onderwerpen voor informatie over het uitvoeren van ontvankelijk ontwerpgedrag:

Tijdens het ontwerpen kunt u Sidekick om een voorvertoning van uw pagina's weer te geven voor verschillende schermgrootten.

Voordat u ontwikkelt before-you-develop

Voordat u de AEM ontwikkelt die uw webpagina's ondersteunt, moet u een aantal ontwerpbeslissingen nemen. U moet bijvoorbeeld over de volgende informatie beschikken:

Toepassingsstructuur application-structure

De typische AEM toepassingsstructuur ondersteunt alle responsieve ontwerpimplementaties:

Mediaquery's gebruiken using-media-queries

Met mediaquery's kunt u CSS-stijlen selectief gebruiken voor het weergeven van pagina's. AEM ontwikkelingshulpmiddelen en eigenschappen laten u toe om media vragen in uw toepassingen effectief en efficiënt uit te voeren.

De W3C-groep biedt de Mediaquery's een aanbeveling die deze CSS3-functie en de syntaxis beschrijft.

Het CSS-bestand maken creating-the-css-file

Definieer in uw CSS-bestand mediaquery's op basis van de eigenschappen van de apparaten waarvoor u een mediaquery maakt. De volgende implementatiestrategie is effectief voor het beheren van stijlen voor elke mediaquery:

De We.Retail In het voorbeeld Media wordt deze strategie gebruikt om stijlen in het siteontwerp te definiëren. Het CSS-bestand gebruikt door We.Retail is om */apps/weretail/clientlibs/clientlib-site/less/grid.less.

In de volgende tabel worden de bestanden in de onderliggende css-map weergegeven.

Het bestand css.txt in het dialoogvenster /etc/designs/weretail/clientlibs in de map worden de CSS-bestanden weergegeven die de map met de clientbibliotheek bevat. De volgorde van de bestanden implementeert stijlprioriteit. Stijlen zijn specifieker naarmate de apparaatgrootte afneemt.

#base=css

style.css
 bootstrap.css

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

Tip: Met beschrijvende bestandsnamen kunt u gemakkelijk de doelgrootte van de viewport identificeren.

Mediaquery's gebruiken met AEM pagina's using-media-queries-with-aem-pages

Neem de clientbibliotheekmap op in het JSP-script van uw paginacomponent. Op deze manier kunt u het CSS-bestand genereren dat de mediaquery's en verwijzingen naar het bestand bevat.

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

Met het JSP-script wordt de volgende HTML-code gegenereerd die verwijst naar de stijlpagina's:

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

Voorvertonen voor specifieke apparaten previewing-for-specific-devices

Bekijk voorvertoningen van uw pagina's in verschillende viewportgrootten zodat u het gedrag van uw responsieve ontwerp kunt testen. In Preview modus, Sidekick omvat een Devices vervolgkeuzemenu dat u gebruikt om een apparaat te selecteren. Wanneer u een apparaat selecteert, wordt de pagina aangepast aan het formaat van de viewport.

De voorvertoning van het apparaat inschakelen in Sidekick moet u de pagina en de MobileEmulatorProvider service. Een andere paginaconfiguratie controleert de lijst van apparaten die in verschijnt Devices lijst.

De lijst met apparaten toevoegen adding-the-devices-list

De Devices lijst wordt weergegeven in Sidekick als uw pagina het JSP-script bevat dat de Devices lijst. Als u de opdracht Devices lijst naar Sidekick, inclusief de /libs/wcm/mobile/components/simulator/simulator.jsp in het head van uw pagina.

Neem de volgende code op in het JSP dat het dialoogvenster head sectie:

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

Als u een voorbeeld wilt bekijken, opent u het dialoogvenster /apps/weretail/components/page/head.jsp bestand in CRXDE Lite.

Paginacomponenten registreren voor simulatie registering-page-components-for-simulation

Als u wilt dat de apparaatsimulator uw pagina's ondersteunt, registreert u uw paginacomponenten bij de MobileEmulatorProvider-fabrieksservice en definieert u de mobile.resourceTypes eigenschap.

Wanneer het werken met AEM, zijn er verscheidene methodes om de configuratiemontages voor dergelijke diensten te beheren; zie OSGi configureren voor volledige informatie.

Als u bijvoorbeeld een [sling:OsgiConfig](/docs/experience-manager-65/content/implementing/deploying/configuring/configuring-osgi.md#adding-a-new-configuration-to-the-repository) knooppunt in uw toepassing:

Voeg de volgende knooppunteigenschap toe:

De apparaatgroepen opgeven specifying-the-device-groups

Als u de apparaatgroepen wilt opgeven die in de lijst met apparaten worden weergegeven, voegt u een cq:deviceGroups eigenschap aan de jcr:content knooppunt van de hoofdpagina van uw site. De waarde van de eigenschap is een array van paden naar de knooppunten van de apparaatgroep.

De knooppunten van de apparaatgroep bevinden zich in de /etc/mobile/groups map.

De hoofdpagina van de site Geometrixx Media is bijvoorbeeld /content/geometrixx-media. De /content/geometrixx-media/jcr:content node bevat de volgende eigenschap:

Gebruik de console van Hulpmiddelen aan apparaatgroepen maken en bewerken.

Aangepaste afbeeldingen gebruiken using-adaptive-images

U kunt mediaquery's gebruiken om een afbeeldingsbron te selecteren die u op de pagina wilt weergeven. Nochtans, wordt elk middel dat een media vraag gebruikt om zijn gebruik te conditionaliseren gedownload aan de cliënt. De mediaquery bepaalt alleen of de gedownloade bron wordt weergegeven.

Voor grote bronnen, zoals afbeeldingen, is het downloaden van alle bronnen geen efficiënt gebruik van de gegevenspijpleiding van de client. Als u bronnen selectief wilt downloaden, gebruikt u JavaScript om de aanvraag voor de bron te starten nadat de mediaquery's de selectie hebben uitgevoerd.

De volgende strategie laadt één enkel middel dat gebruikend media vragen wordt gekozen:

Mediaquery's evalueren met JavaScript evaluating-media-queries-using-javascript

Uitvoeringen van de Interface MediaQueryList dat W3C definieert, kunt u mediaquery's evalueren met behulp van JavaScript. U kunt logica toepassen op de resultaten van mediaquery's en scripts uitvoeren die zijn bedoeld voor het huidige venster:

Media-specifieke bronnen selecteren selecting-media-specific-resources

De W3C afbeeldingselement gebruikt mediaquery's om te bepalen welke bron moet worden gebruikt voor afbeeldingselementen. Het afbeeldingselement gebruikt elementkenmerken om mediaquery's te koppelen aan afbeeldingspaden.

De vrij beschikbare bibliotheek picturefill.js biedt vergelijkbare functionaliteit als de voorgestelde picture en gebruikt een vergelijkbare strategie. De bibliotheek picturefill.js roept aan window.matchMedia om de mediaquery's te evalueren die zijn gedefinieerd voor een set div elementen. Elk div -element geeft ook een afbeeldingsbron op. De bron wordt gebruikt wanneer de mediaquery van de div elementgeretourneerd true.

De picturefill.js voor bibliotheek is HTML-code vereist die vergelijkbaar is met het volgende voorbeeld:

<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>

Wanneer de pagina wordt weergegeven, voegt picturefull.js een img element as the last child of the <div data-picture> element:

<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>

In een AEM pagina, de waarde van data-src attribuut is de weg aan een middel in de bewaarplaats.

Adaptieve afbeeldingen implementeren in AEM implementing-adaptive-images-in-aem

Als u adaptieve afbeeldingen wilt implementeren in uw AEM, moet u de vereiste JavaScript-bibliotheken toevoegen en de vereiste HTML-markering opnemen in uw pagina's.

Bibliotheken

Verkrijg de volgende bibliotheken JavaScript en neem hen in een omslag van de cliëntbibliotheek op:

Tip: U kunt automatisch meerdere clientbibliotheekmappen samenvoegen door insluiten.

HTML

Maak een component die de vereiste div-elementen genereert die de code picturefill.js verwacht. In een AEM pagina, is de waarde van het gegeven-src attribuut de weg aan een middel in de bewaarplaats. Een paginacomponent kan bijvoorbeeld de mediaquery's en de bijbehorende paden voor afbeeldingsuitvoeringen in DAM hard coderen. U kunt ook een aangepaste component Image maken waarmee auteurs afbeeldingsuitvoeringen kunnen selecteren of renderopties bij uitvoering kunnen opgeven.

In het volgende voorbeeld wordt HTML geselecteerd uit twee DAM-uitvoeringen van dezelfde afbeelding.

<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>

Renderen van afbeeldingen in AEM understanding-image-rendering-in-aem

Als u de rendering van afbeeldingen wilt aanpassen, dient u de standaardimplementatie AEM statische rendering van afbeeldingen te begrijpen. AEM biedt de component Image en een server voor het renderen van afbeeldingen die samenwerken om afbeeldingen voor webpagina's te renderen. De volgende volgorde van gebeurtenissen vindt plaats wanneer de component Image is opgenomen in het alineasysteem van de pagina:

De JSP van de component Image genereert bijvoorbeeld het volgende HTML-element:

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

Wanneer de browser de pagina laadt, wordt de afbeelding opgevraagd met de waarde van het kenmerk src als URL. Bij Sling wordt de URL ontleed:

De image_0 knooppunt heeft een jcr:resourceType waarde van foundation/components/image, die een sling:resourceSuperType waarde van foundation/components/parbase. De parbase component bevat het script img.GET.java dat overeenkomt met de kiezer en de bestandsextensie van de aanvraag-URL. CQ gebruikt dit script (servlet) om de afbeelding te renderen.

Als u de broncode van het script wilt zien, gebruikt u CRXDE Lite om het dialoogvenster /libs/foundation/components/parbase/img.GET.java
bestand.

Afbeeldingen schalen voor de huidige viewport-grootte scaling-images-for-the-current-viewport-size

Afbeeldingen tijdens runtime schalen op basis van de kenmerken van de viewport van de client om afbeeldingen te maken die voldoen aan de principes van responsief ontwerp. Gebruik hetzelfde ontwerppatroon als het renderen van statische afbeeldingen met behulp van een servlet en een ontwerpcomponent.

De component moet de volgende taken uitvoeren:

servlet die het beeldverzoek verwerkt moet de volgende taken uitvoeren:

Beschikbare oplossingen

AEM installeert de volgende implementaties die u kunt gebruiken of uitbreiden.

De component Adaptieve afbeelding understanding-the-adaptive-image-component

De adaptieve component van het Beeld produceert vraag aan de Adaptive Servlet van de Component van het Beeld om een beeld terug te geven dat volgens het apparatenscherm wordt gerangschikt. De component bevat de volgende bronnen:

De DIV-elementen toevoegen adding-the-div-elements

Het script adaptive-image.jsp bevat de volgende code waarmee div-elementen en mediaquery's worden gegenereerd:

<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>

De path variable contains the path of the current resource (the adaptive-image component node). De code genereert een reeks div elementen met de volgende structuur:

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

De waarde van data-scr Dit kenmerk is een URL die Sling oplost naar de Adaptive Image Component Servlet die de afbeelding rendert. Het data-media attribuut bevat de media vraag die tegen de cliënteigenschappen wordt geëvalueerd.

De volgende HTML-code is een voorbeeld van de div elementen die door het JSP worden gegenereerd:

<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>

Selectors voor afbeeldingsgrootte wijzigen changing-the-image-size-selectors

Als u de component Adaptive Image aanpast en de breedteselectors wijzigt, moet u ook de Adaptive Image Component Servlet configureren om de breedten te ondersteunen.

De Adaptive Image Component Server understanding-the-adaptive-image-component-servlet

De adaptieve server van de Component van het Beeld resizes een beeld van JPEG volgens een gespecificeerde breedte, en plaatst de kwaliteit van de JPEG.

De interface van de Adaptive Image Component Server the-interface-of-the-adaptive-image-component-servlet

De server voor adaptieve afbeeldingscomponenten is gebonden aan het standaard-Sling-servlet en ondersteunt de bestandsextensies .jpg, .jpeg, .gif en .png. De servletkiezer is img.

Daarom lost het Sling URLs van het HTTP- verzoek van het volgende formaat aan dit servlet op:

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

Bijvoorbeeld HTTP-aanvragen doorsturen met de URL http://localhost:4502/content/geometrixx/adaptiveImage.img.jpg naar Adaptive Image Component Server.

Twee extra kiezers geven de gewenste afbeeldingsbreedte en -kwaliteit op. In het volgende voorbeeld wordt een afbeelding met een breedte van 480 pixels en een gemiddelde kwaliteit opgevraagd:

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

Ondersteunde afbeeldingseigenschappen

De servlet accepteert een eindig aantal afbeeldingsbreedten en -kwaliteiten. De volgende breedten worden standaard ondersteund (in pixels):

De volledige waarde geeft aan dat er geen schaling is.

De volgende waarden voor de kwaliteit van de JPEG worden ondersteund:

De numerieke waarden zijn respectievelijk 0,4, 0,82 en 1,0.

De standaard ondersteunde breedten wijzigen

De webconsole gebruiken (http://localhost:4502/system/console/configMgr) of een sling:OsgiConfig-knooppunt om de ondersteunde breedten van de Adobe CQ Adaptive Image Component Servlet te configureren.

Voor informatie over hoe te om AEM diensten te vormen, zie OSGi configureren.

Implementatiedetails implementation-details

De com.day.cq.wcm.foundation.impl.AdaptiveImageComponentServlet klasse breidt de AbstractImageServlet klasse. De AdaptiveImageComponentServlet-broncode bevindt zich in de /libs/foundation/src/impl/src/com/day/cq/wcm/foundation/impl map.

De klasse gebruikt de SCR annotaties van Felix om het middeltype en de dossieruitbreiding te vormen die servlet met, en de naam van de eerste selecteur wordt geassocieerd.

@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)
})

servlet gebruikt de SCR annotatie van het Bezit om de standaard gesteunde beeldkwaliteit en afmetingen te plaatsen.

@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.")

De AbstractImageServlet klasse biedt de doGet methode die de HTTP-aanvraag verwerkt. Deze methode bepaalt het middel dat met het verzoek wordt geassocieerd, wint middeleigenschappen van de bewaarplaats terug, en keert hen in terug ImageContext object.

De AdaptiveImageComponentServlet klasse overschrijft de klasse createLayer methode. De methode verkrijgt de weg van het beeldmiddel en de gevraagde beeldbreedte van ImageContext object. Het roept dan de methodes van info.geometrixx.commons.impl.AdaptiveImageHelper klasse, die de werkelijke schaling van de afbeelding uitvoert.

De klasse AdaptiveImageComponentServlet overschrijft ook de methode writeLayer. Met deze methode past u de kwaliteit van de JPEG toe op de afbeelding.

Servlet van de Wijziging van de Verwijzing van het beeld (Gemeenschappelijke Geometrixx) image-reference-modification-servlet-geometrixx-common

Met de voorbeeldserver voor het wijzigen van afbeeldingsreferenties worden groottekenmerken voor het img-element gegenereerd om een afbeelding op de webpagina te schalen.

De servlet aanroepen calling-the-servlet

De servlet is gebonden aan cq:page bronnen en ondersteunt de bestandsextensie .jpg. De servlet-kiezer is image. Daarom lost het Sling URLs van het HTTP- verzoek van het volgende formaat aan dit servlet op:

path-to-page-node.image.jpg

Bijvoorbeeld HTTP-aanvragen doorsturen met de URL http://localhost:4502/content/geometrixx/en.image.jpg naar Servlet voor wijziging van afbeeldingsverwijzing.

Drie extra kiezers geven de gewenste afbeeldingsbreedte, -hoogte en (optioneel) -kwaliteit op. In het volgende voorbeeld wordt een afbeelding met een breedte van 770 pixels, een hoogte van 360 pixels en een gemiddelde kwaliteit opgevraagd.

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

Ondersteunde afbeeldingseigenschappen

De servlet accepteert een eindig aantal afbeeldingsafmetingen en kwaliteitswaarden.

De volgende waarden worden standaard ondersteund (breedte):

De volgende waarden voor de afbeeldingskwaliteit worden ondersteund:

Wanneer het werken met AEM, zijn er verscheidene methodes om de configuratiemontages voor dergelijke diensten te beheren; zie OSGi configureren voor volledige informatie.

De afbeeldingsbron opgeven specifying-the-image-resource

Het afbeeldingspad, de afmetingen en de kwaliteitswaarden moeten worden opgeslagen als eigenschappen van een knooppunt in de opslagplaats:

Wanneer u een pagina ontwerpt, gebruikt u Sidekick om de afbeelding op te geven en de image knooppunt naar de pagina-eigenschappen:

Implementatiedetails implementation-details-1

De klasse info.geometrixx.commons.impl.servlets.ImageReferenceModificationServlet breidt de klasse AbstractImageServlet klasse. Als u het cq-geometrixx-commons-pkg-pakket hebt geïnstalleerd, bevindt de ImageReferenceModificationServlet-broncode zich in de /apps/geometrixx-commons/src/core/src/main/java/info/geometrixx/commons/impl/servlets map.

De klasse gebruikt de SCR annotaties van Felix om het middeltype en de dossieruitbreiding te vormen die servlet met, en de naam van de eerste selecteur wordt geassocieerd.

@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)
})

servlet gebruikt de SCR annotatie van het Bezit om de standaard gesteunde beeldkwaliteit en afmetingen te plaatsen.

@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.")

De AbstractImageServlet klasse biedt de doGet methode die de HTTP-aanvraag verwerkt. Deze methode bepaalt het middel dat met de vraag wordt geassocieerd, wint middeleigenschappen van de bewaarplaats terug, en bewaart hen in een ImageContext object.

De ImageReferenceModificationServlet klasse overschrijft de klasse createLayer en implementeert de logica die de te renderen afbeeldingsbron bepaalt. De methode haalt een onderliggende node van de pagina op jcr:content node benoemd image. An Afbeelding op basis van dit object gemaakt image en de getFileReference retourneert het pad naar het afbeeldingsbestand vanuit de methode fileReference eigenschap van het afbeeldingsknooppunt.

Een dynamisch raster ontwikkelen developing-a-fluid-grid

AEM stelt u in staat op efficiënte en effectieve wijze dynamische rasters te implementeren. Op deze pagina wordt uitgelegd hoe u uw dynamische raster of een bestaande rasterimplementatie (zoals Bootstrap) in uw AEM toepassing.

Als u niet vertrouwd bent met dynamische rasters, raadpleegt u de Inleiding tot dynamische rasters onder aan deze pagina. Deze inleiding geeft een overzicht van dynamische rasters en richtlijnen voor het ontwerpen ervan.

Het raster definiëren met een component Pagina defining-the-grid-using-a-page-component

Gebruik paginacomponenten om de HTML-elementen te genereren die de inhoudsblokken van de pagina definiëren. De ClientLibraryFolder waarnaar de pagina verwijst, bevat de CSS die de lay-out van de inhoudsblokken bepaalt:

De voorbeeldgeometrixx-media-toepassing bevat bijvoorbeeld de media-home-component. Deze pagina-component voegt twee scripts in, die twee scripts genereren div elementen van klasse 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>

Het raster van de component Pagina schalen scaling-the-page-component-grid

Het ontwerp dat aan de geometrixx-media paginacomponent (/etc/designs/geometrixx-media) bevat de clientlibs ClientLibraryFolder. Deze ClientLibraryFolder bepaalt CSS stijlen voor row-fluid klassen, span* klassen, en span* klassen die onderliggende zijn van row-fluid klassen. Met mediaquery's kunnen stijlen opnieuw worden gedefinieerd voor verschillende viewportgrootten.

In het volgende voorbeeld is CSS een subset van deze stijlen. Deze subset is gericht op span12, span8, en span4 en mediaquery's voor twee viewportgrootten. Let op de volgende kenmerken van de 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% }
}

Inhoud in het raster van de component Pagina verplaatsen repositioning-content-in-the-page-component-grid

Op de pagina's van de voorbeeldtoepassing worden rijen met inhoudsblokken horizontaal verdeeld in brede viewports. In kleinere viewports, worden de zelfde blokken verticaal verdeeld. In het volgende voorbeeld-CSS worden de stijlen getoond die dit gedrag implementeren voor de HTML-code die door de pagina-component Media-home wordt gegenereerd:

/* 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%;
    }
}

De paginacomponenten moduleren tip-modularize-your-page-components

Modulariseer uw componenten zodat kunt u efficiënt gebruik van de code maken. Uw site gebruikt waarschijnlijk verschillende typen pagina's, zoals een welkomstpagina, een artikelpagina of een productpagina. Elk type pagina bevat verschillende typen inhoud en gebruikt waarschijnlijk verschillende lay-outs. Wanneer bepaalde elementen van elke lay-out echter op meerdere pagina's voorkomen, kunt u de code die dat deel van de lay-out implementeert, opnieuw gebruiken.

Bedekkingen van pagina-componenten gebruiken

Een hoofdpaginacomponent maken die scripts biedt voor het genereren van de verschillende delen van een pagina, zoals head en body secties, en header, content, en footer in het lichaam.

Andere paginacomponenten maken die de hoofdpaginacomponent als de cq:resourceSuperType. Deze componenten omvatten manuscripten die de manuscripten van de belangrijkste pagina zonodig met voeten treden.

De toepassing goemetrixx-media bevat bijvoorbeeld de paginacomponent sling:resourceSuperType is de component van de stichtingspagina). Verschillende onderliggende componenten (zoals artikel, categorie en media-home) gebruiken deze pagina-component als de sling:resourceSuperType. Elke onderliggende component bevat een content.jsp-bestand dat het content.jsp-bestand van de paginacomponent overschrijft.

Scripts opnieuw gebruiken

Creeer veelvoudige manuscripten JSP die rij en kolomcombinaties produceren die voor veelvoudige paginacomponenten gemeenschappelijk zijn. Bijvoorbeeld de content.jsp het script van het artikel en de media-home-componenten verwijzen beide naar de 8x4col.jsp script.

CSS-stijlen ordenen op doelgrootte van viewport

CSS-stijlen en mediaquery's voor verschillende viewportgrootten opnemen in afzonderlijke bestanden. Gebruik clientbibliotheekmappen om deze samen te voegen.

Componenten invoegen in het paginaraster inserting-components-into-the-page-grid

Wanneer componenten één blok van inhoud produceren, over het algemeen controleert het net dat de paginacomponent vestigt de plaatsing van de inhoud.

Als auteur kan het inhoudsblok worden gerenderd in verschillende formaten en relatieve posities. De inhoudstekst zou geen relatieve richtingen moeten gebruiken om naar andere inhoudsblokken te verwijzen.

Indien nodig moet de component alle CSS- of JavaScript-bibliotheken leveren die vereist zijn voor de door de component gegenereerde HTML-code. Gebruik een clientbibliotheekmap in de component, zodat de CSS- en JS-bestanden worden gegenereerd. De bestanden beschikbaar maken: een afhankelijkheid maken of de bibliotheek insluiten in een andere clientbibliotheekmap onder de map /etc.

Subrasters

Als de component meerdere blokken inhoud bevat, voegt u de inhoudsblokken in een rij toe om een subraster op de pagina te maken:

Bijvoorbeeld de /apps/geometrixx-media/components/2-col-article-summary worden twee kolommen met inhoud gegenereerd. De HTML die wordt gegenereerd, heeft de volgende structuur:

<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>

De .row-fluid .span6 kiezers van de CSS van de pagina zijn van toepassing op de div elementen van dezelfde klasse en structuur in deze HTML. De component bevat echter ook de clientbibliotheekmap /apps/geometrixx-media/components/2-col-article-summary/clientlibs:

De volgende stijlen zijn bijvoorbeeld opgenomen in de /apps/geometrixx-media/components/2-col-article-summary/clientlibs/css/responsive-480px.css bestand:

@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;
    }
}

Inleiding tot vloeistofrasters introduction-to-fluid-grids

Met dynamische rasters kunt u paginalay-outs aanpassen aan de afmetingen van de viewport van de client. Rasters bestaan uit logische kolommen en rijen die de blokken inhoud op de pagina plaatsen.

Met behulp van HTML5-technologie kunt u het raster implementeren en bewerken om de paginalay-outs aan te passen aan verschillende viewportgrootten:

discrete breedten gebruiken using-discrete-widths

Gebruik voor elk bereik van viewportbreedten waarop u zich richt een statische paginabreedte en inhoudsblokken met constante breedte. Als u de grootte van een browservenster handmatig wijzigt, worden wijzigingen in de inhoudsgrootte aangebracht op verschillende vensterbreedten (ook wel onderbrekingspunten genoemd). Paginaontwerpen worden daarom nauwkeuriger toegepast, zodat de gebruiker er optimaal mee kan werken.

Het raster schalen scaling-the-grid

Gebruik rasters om inhoudsblokken te schalen en deze aan te passen aan verschillende viewportgrootten. Inhoudsblokken beslaan een specifiek aantal kolommen. Naarmate de kolombreedten groter of kleiner worden om in verschillende viewportgrootten te passen, neemt de breedte van de inhoudsblokken dienovereenkomstig toe of af. Schalen kan zowel grote als middelgrote viewports steunen die genoeg breed zijn om de zij-aan-zijplaatsing van inhoudsblokken aan te passen.

Inhoud in het raster verplaatsen repositioning-content-in-the-grid

De grootte van inhoudsblokken kan worden beperkt door een minimumbreedte, waarvoorbij schalen niet meer effectief is. Voor kleinere viewports, kan het net worden gebruikt om blokken van inhoud verticaal te verdelen eerder dan horizontaal.

Het raster ontwerpen designing-the-grid

Bepaal de kolommen en rijen die u de blokken inhoud op uw pagina's moet plaatsen. De paginalay-outs bepalen het aantal kolommen en rijen dat het raster omspannen.

Aantal kolommen

Neem voldoende kolommen op om de inhoudsblokken horizontaal voor alle viewportgrootten in al uw lay-outs te plaatsen. Gebruik meer kolommen dan u momenteel nodig hebt, zodat u toekomstige paginaontwerpen kunt aanpassen.

Rijinhoud

Gebruik rijen om de verticale plaatsing van inhoudsblokken te bepalen. Bepaal de inhoudsblokken die dezelfde rij delen:

Rasterimplementaties grid-implementations

Maak CSS-klassen en -stijlen, zodat u de lay-out van de inhoudsblokken op een pagina kunt bepalen. Paginaontwerpen zijn vaak gebaseerd op de relatieve grootte en positie van inhoudsblokken in de viewport. De viewport bepaalt de daadwerkelijke grootte van de inhoudsblokken. In uw CSS moet rekening worden gehouden met de relatieve en absolute grootten. U kunt een dynamisch raster implementeren met drie typen CSS-klassen:

De gerichte viewport breedten (en hun bijbehorende media vragen) wijzen discrete breedten af die voor een paginalay-out worden gebruikt.

Breedten van inhoudsblokken widths-of-content-blocks

In het algemeen geldt dat width stijlen van klassen voor inhoudsblokken zijn gebaseerd op de volgende kenmerken van de pagina en het raster:

CSS omvat een reeks media vragen die de volgende structuur gebruiken:

@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 }
  ...
}

Gebruik het volgende algoritme als uitgangspunt voor het ontwikkelen van de elementklassen en CSS stijlen voor uw pagina's.

Inhoudsblokken in rijen plaatsen positioning-content-blocks-in-rows

De floatstijl van het dialoogvenster .row-fluid -klasse zodat u kunt bepalen of de inhoudsblokken in een rij horizontaal of verticaal worden gerangschikt.

Voeg de stijl toe aan de .row-fluid in elke mediaquery. Stel de waarde in op basis van de pagina-indeling die u gebruikt voor de mediaquery. Het volgende diagram illustreert bijvoorbeeld een rij die inhoud horizontaal verdeelt voor brede viewports, en verticaal voor smalle viewports.

In de volgende CSS kan dit gedrag worden geïmplementeerd:

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

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

Klassen toewijzen aan inhoudsblokken assigning-classes-to-content-blocks

Voor de paginalay-out van elke viewport grootte u richt, bepaal het aantal kolommen dat elk inhoudsblok overspant. Bepaal vervolgens welke klasse moet worden gebruikt voor de div-elementen van die inhoudsblokken.

Wanneer u de div-klassen hebt ingesteld, kunt u het raster implementeren met de AEM toepassing.