AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.
Adobe raadt u aan de SPA Editor te gebruiken voor projecten waarvoor rendering op basis van één pagina op basis van raamwerk van toepassingen vereist is (zoals Reageren). Meer informatie.
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 de AEM ontwikkelt die uw webpagina's ondersteunt, moet u een aantal ontwerpbeslissingen nemen. U moet bijvoorbeeld over de volgende informatie beschikken:
De typische AEM toepassingsstructuur ondersteunt alle responsieve ontwerpimplementaties:
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.
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:
In het voorbeeldformulier We.Retail Media wordt deze strategie gebruikt om stijlen in het siteontwerp te definiëren. Het CSS-bestand dat wordt gebruikt door We.Retail bevindt zich op */apps/weretail/clientlibs/clientlib-site/less/grid.less
.
In de volgende tabel worden de bestanden in de onderliggende css-map weergegeven.
Bestandsnaam | Beschrijving | Mediaquery |
---|---|---|
style.css | Algemene stijlen. | N.v.t. |
bootstrap.css | Algemene stijlen, gedefinieerd door Twitter Bootstrap. | N.v.t. |
responsive-1200px.css | Stijlen voor alle media die 1200 pixels breed of breder zijn. | @media (min-width: 1200px) { |
responsive-980px-1199px.css | Stijlen voor media die tussen 980 pixels en 1199 pixels breed zijn. | @media (min-width: 980px) and (max-width: 1199px) { |
responsive-768px-979px.css | Stijlen voor media die tussen 768 pixels en 979 pixels breed zijn. | @media (min-breedte): 768 px) en (max. breedte: 979 px) { |
responsive-767px-max.css | Stijlen voor alle media die minder dan 768 pixels breed zijn. | @media (max-width: 767px) { |
responsive-480px.css | Stijlen voor alle media die minder dan 481 pixels breed zijn. | @media (max-width: 480) { ... } |
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 de doelgrootte van de viewport gemakkelijk identificeren.
Neem de clientbibliotheekmap op in het JSP-script van uw paginacomponent om het CSS-bestand te genereren dat de mediaquery's bevat en naar het bestand te verwijzen.
<ui:includeClientLib categories="apps.weretail.all"/>
De apps.weretail.all
clientbibliotheekmap sluit de clientlibs-bibliotheek in.
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">
Bekijk voorvertoningen van uw pagina's in verschillende viewport grootten om het gedrag van uw responsieve ontwerp te testen. In Preview modus, Sidekick omvat een Devices vervolgkeuzelijst die 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 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.
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-64/deploying/configuring/configuring-osgi.md#adding-a-new-configuration-to-the-repository)
in uw toepassing:
Bovenliggende map: /apps/application_name/config
Naam: com.day.cq.wcm.mobile.core.impl.MobileEmulatorProvider-*alias*
De *alias*
achtervoegsel wordt vereist omdat de dienst MobileEmulatorProvider een fabrieksdienst is. Gebruik een alias die uniek is voor deze fabriek.
jcr:primaryType: sling:OsgiConfig
Voeg de volgende knooppunteigenschap toe:
Naam: mobile.resourceTypes
Type: String[]
Waarde: De paden naar de paginacomponenten die uw webpagina's weergeven. De geometrixx-media-app gebruikt bijvoorbeeld de volgende waarden:
geometrixx-media/components/page
geometrixx-unlimited/components/pages/page
geometrixx-unlimited/components/pages/coverpage
geometrixx-unlimited/components/pages/issue
Als u de apparaatgroepen wilt opgeven die in de lijst met apparaten worden weergegeven, voegt u een cq:deviceGroups
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.
Apparaatgroepknooppunten 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:
cq:deviceGroups
String[]
/etc/mobile/groups/responsive
Gebruik de console van Hulpmiddelen om apparaatgroepen maken en bewerken.
Voor apparaatgroepen die u gebruikt voor responsief ontwerp, bewerkt u de apparaatgroep en selecteert u Emulator uitschakelen op het tabblad Algemeen. Met deze optie voorkomt u dat de carrousel van de emulator wordt weergegeven. Dit is niet relevant voor responsief ontwerp.
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. Om middelen selectief te downloaden, gebruik javascript om het middelverzoek in werking te stellen nadat de media vragen de selectie uitvoeren.
De volgende strategie laadt één enkel middel dat gebruikend media vragen wordt gekozen:
Uitvoeringen van de Interface MediaQueryList dat W3C bepaalt laat u toe om media vragen te evalueren gebruikend javascript. U kunt logica toepassen op de resultaten van mediaquery's en scripts uitvoeren die zijn bedoeld voor het huidige venster:
Browsers die de interface MediaQueryList implementeren, ondersteunen de window.matchMedia()
functie. Deze functie test mediaquery's op basis van een bepaalde tekenreeks. De functie retourneert een MediaQueryList
-object dat toegang biedt tot de queryresultaten.
Voor browsers die de interface niet implementeren, kunt u een matchMedia()
polyvulling, zoals matchMedia.js, een vrij beschikbare javascript-bibliotheek.
Het door W3C voorgestelde 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 bibliotheekaanroepen picturefill.js window.matchMedia
om de mediaquery's te evalueren die zijn gedefinieerd voor een set van 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.
Als u adaptieve afbeeldingen wilt implementeren in de AEM toepassing, moet u de vereiste JavaScript-bibliotheken toevoegen en de vereiste HTML-opmaakcode op de pagina's opnemen.
Bibliotheken
Haal de volgende JavaScript-bibliotheken op en neem deze op in een clientbibliotheekmap:
/etc/clientlibs/granite/jquery
clientbibliotheekmap (categorie = jquery)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 2 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>
De stichtingscomponent Adaptive Image implementeert adaptieve afbeeldingen:
/libs/foundation/components/adaptiveimage/clientlibs
/libs/foundation/components/adaptiveimage/adaptiveimage.jsp
In het volgende gedeelte vindt u meer informatie over deze component.
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 reeks 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:
/content/mywebsite/en/_jcr_content/par/image_0
.jpg
img
1358372073597.jpg
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 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:
div
elementen die mediaselectors bevatten en serviceoproepen voor het renderen van de afbeelding.De webclient gebruikt de Javascript-bibliotheken (of vergelijkbare bibliotheken) matchMedia en Picturefill om de mediaselectors te evalueren.
servlet die het beeldverzoek verwerkt moet de volgende taken uitvoeren:
Beschikbare oplossingen
AEM installeert de volgende implementaties die u kunt gebruiken of uitbreiden.
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:
cq:ClientLibraryFolder
die de javascript-bibliotheek matchMedia polyfill en een gewijzigde Javascript-bibliotheek met Picturefill samenvoegt.cq:editConfig
-knooppunt overschrijft de CQ-component van de basisimage, zodat het neerzetdoel een adaptieve-afbeeldingscomponent maakt in plaats van een component van de basisimage.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 de 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>
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 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 server voor adaptieve afbeeldingscomponenten is gebonden aan de standaard-Sling-server en ondersteunt de bestandsextensies .jpg, .jpeg, .gif en .png. De servletkiezer is img.
Geanimeerde .gif-bestanden worden niet ondersteund in AEM voor adaptieve uitvoeringen.
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 Servlet.
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.
Webconsole | sling:OsgiConfig | |
---|---|---|
Service- of knooppuntnaam | De servicenaam op het tabblad Configuratie is Adobe CQ Adaptive Image Component Servlet | com.day.cq.wcm.foundation.impl. AdaptiveImageComponentServlet |
Eigenschap | Ondersteunde breedten
|
adapt.supported.widths
|
De com.day.cq.wcm.foundation.impl.AdaptiveImageComponentServlet
klasse breidt de AbstractImageServlet klasse. De AdaptiveImageComponentServlet-broncode bevindt zich in het gedeelte /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 com.day.cq.commons.DownloadResource klasse biedt de getFileReference method
, die de waarde van de bron ophaalt fileReference
eigenschap.
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.
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 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.
Het afbeeldingspad, de afmetingen en de kwaliteitswaarden moeten worden opgeslagen als eigenschappen van een knooppunt in de opslagplaats:
De knooppuntnaam is image
.
Het bovenliggende knooppunt is het jcr:content
knooppunt van een cq:page
resource.
Het afbeeldingspad wordt opgeslagen als de waarde van een eigenschap met de naam fileReference
.
Wanneer u een pagina ontwerpt, gebruikt u Sidetrap om de afbeelding op te geven en de image
knooppunt naar de pagina-eigenschappen:
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 het dialoogvenster /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 onderliggend knooppunt van de pagina op jcr:content
node benoemd image
. An Afbeelding op basis van dit object gemaakt image
en de getFileReference
Hiermee wordt het pad naar het afbeeldingsbestand geretourneerd vanuit de methode fileReference
eigenschap van het afbeeldingsknooppunt.
De com.day.cq.commons.DownloadResource biedt de methode getFileReference.
AEM stelt u in staat op efficiënte en effectieve wijze dynamische rasters te implementeren. Deze pagina verklaart hoe u uw dynamisch net of een bestaande netimplementatie (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.
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
:
De eerste rij bevat een div
element of class span12
(de inhoud omvat 12 kolommen). De div
element bevat de component parsys.
De tweede rij bevat twee div
elementen, één van klasse span8
en de andere klasse span4
. Elk div
het element omvat de component parsys.
<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>
Wanneer een component meerdere componenten bevat cq:include
elementen die van verwijzingen voorzien de parsys component, elk path
kenmerk moet een andere waarde hebben.
Het ontwerp dat aan de geometrixx-media paginacomponent (/etc/designs/geometrixx-media
) bevat de clientlibs
ClientLibraryFolder. Deze ClientLibraryFolder definieert 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:
.span
stijlen definiëren elementbreedten met absolute getallen..row-fluid .span*
stijlen definiëren elementbreedten als percentages van het bovenliggende element. Percentages worden berekend op basis van de absolute breedten.In het voorbeeld Geometrixx Media wordt het Bootstrap javascript-framework in de dynamische rasterimplementatie. Het Bootstrap-framework biedt het bestand bootstrap.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% }
}
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:
De standaard-CSS voor de media-welkomstpagina wijst de float:left
stijl voor span*
klassen binnen row-fluid
klassen.
De vragen van media voor kleinere viewports wijzen toe float:none
stijl voor dezelfde klassen.
/* 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%;
}
}
Modulariseer uw componenten om efficiënt gebruik van de code te 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 (de sling:resourceSuperType
is de component van de stichtingspagina). Verschillende onderliggende componenten (zoals artikel, categorie en media-home) gebruiken deze paginacomponent 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. 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.
Wanneer componenten één blok van inhoud produceren, over het algemeen controleert het net dat de paginacomponent vestigt de plaatsing van de inhoud.
Auteurs moeten zich ervan bewust zijn dat het inhoudsblok in verschillende formaten en relatieve posities kan worden weergegeven. 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 om de CSS- en JS-bestanden te genereren. Om de bestanden toegankelijk te 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:
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:
multi-col-article-summary
klasse van de rij div
-element dat het gedrag van de pagina overschrijft row-fluid
klasse.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;
}
}
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:
div
elementen bevatten blokken inhoud die een bepaald aantal kolommen omspannen.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). Hierdoor worden paginaontwerpen nauwkeuriger toegepast, zodat de gebruiker er optimaal mee kan werken.
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.
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.
Bepaal de kolommen en rijen die u nodig hebt om de blokken inhoud op uw pagina's te 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. U zou meer kolommen dan momenteel nodig moeten gebruiken om toekomstige paginaontwerpen aan te passen.
Rijinhoud
Gebruik rijen om de verticale plaatsing van inhoudsblokken te bepalen. Bepaal de inhoudsblokken die dezelfde rij delen:
Maak CSS-klassen en -stijlen om de lay-out van de inhoudsblokken op een pagina te 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:
div
element dat een container voor alle rijen is. Deze klasse stelt de absolute breedte van het raster in.div
elementen die een rij vertegenwoordigen. Deze klasse bepaalt de horizontale of verticale plaatsing van de inhoudsblokken die de klasse bevat.div
elementen die blokken inhoud van verschillende breedten vertegenwoordigen. Breedten worden uitgedrukt als een percentage van het bovenliggende element (de rij).De gerichte viewport breedten (en hun bijbehorende media vragen) wijzen discrete breedten af die voor een paginalay-out worden gebruikt.
In het algemeen geldt dat width
De stijl van de klassen van het inhoudsblok is gebaseerd op de volgende kenmerken van uw pagina en net:
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.
Definieer een klassenaam voor het div-element dat alle rijen bevat, bijvoorbeeld content.
Een CSS-klasse definiëren voor div-elementen die rijen vertegenwoordigen, zoals row-fluid
.
Definieer klassenamen voor elementen van inhoudsblokken. Een klasse is vereist voor alle mogelijke breedten, in termen van kolombereiken. Gebruik bijvoorbeeld de span3
klasse voor div
elementen die 3 kolommen omspannen, gebruiken span4
klassen voor reeksen van 4 kolommen. Definieer zoveel klassen als er kolommen in het raster staan.
Voor elke viewport grootte die u richt, voeg de overeenkomstige media vraag aan uw CSS dossier toe. Voeg de volgende items toe aan elke mediaquery:
content
klasse, bijvoorbeeld .content{}
..span3{ }
.row-fluid
klasse, bijvoorbeeld .row-fluid{ }
.row-fluid span3 { }
.Breedtestijlen toevoegen voor elke kiezer:
content
kiezers naar de absolute grootte van de pagina, bijvoorbeeld width:480px
.(absolute width of page)/(number of columns)
..row-fluid .span
kiezers als een percentage van de totale breedte. Deze breedte berekenen met de opdracht (absolute span width)/(absolute page width)*100
formule.De floatstijl van het dialoogvenster .row-fluid
klasse om te bepalen of de inhoudsblokken in een rij horizontaal of verticaal worden geschikt.
De float:left
of float:right
stijl veroorzaakt de horizontale distributie van kindelementen (inhoudsblokken).
De float:none
stijl veroorzaakt verticale distributie van kindelementen.
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
}
}
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.