Konfigurera layoutbehållare och layoutläge configuring-layout-container-and-layout-mode
Responsiv layout är en mekanism för att implementera responsiv webbdesign. På så sätt kan användaren skapa webbsidor som har en layout och dimensioner som är beroende av vilka enheter som användarna använder.
AEM realiserar responsiv layout för dina sidor med en kombination av mekanismer:
-
Layoutbehållare komponent
Den här komponenten har ett rutnätsstyckesystem där du kan lägga till och placera komponenter i ett responsivt rutnät. Den kan användas som standardparsyta för sidan och/eller göras tillgänglig för författare i komponentwebbläsaren.
-
Standardvärdet Layoutbehållare -komponenten definieras under:
/libs/wcm/foundation/components/responsivegrid
-
Du kan definiera layoutbehållare:
-
Som en komponent som användaren kan lägga till på en sida.
-
Som standardparsys för sidan.
-
Båda.
Du kan ha layoutbehållaren som standard för sidan, samtidigt som användaren kan lägga till fler layoutbehållare i den här versionen. till exempel för att uppnå kolumnkontroll.
-
-
-
Layoutläge
När layoutbehållaren är placerad på sidan kan du använda
Layout läge för att placera innehåll i det responsiva rutnätet. -
Emulator
På så sätt kan du skapa och redigera responsiva webbplatser som ändrar layouten efter enhetens/fönstrets storlek genom att ändra komponenternas storlek interaktivt. Användaren kan sedan se hur innehållet återges med hjälp av emulatorn.
Med dessa responsiva rutnätsmekanismer kan du:
- Använd brytpunkter (som indikerar enhetsgruppering) för att definiera olika innehållsbeteenden baserat på enhetslayout.
- Dölj komponenter baserat på enhetsgrupp (definiera på vilken brytpunkt en komponent ska döljas).
- Använd vågrät fäst mot rutnät (placera komponenter i rutnätet, ändra storlek efter behov, definiera när de ska komprimeras/omformas så att de ligger sida vid sida eller ovanför/nedanför).
- Uppnå kolumnkontroll.
Konfigurera den responsiva emulatorn configuring-the-responsive-emulator
Med de här åtgärderna kan du se de responsiva Emulator på din webbplats.
Registrera dina sidkomponenter för emulering register-your-page-components-for-emulation
Om du vill att emulatorn ska ha stöd för dina sidor måste du registrera sidkomponenterna. Se Registrerar sidkomponenter för simulering.
Ange enhetsgrupper specify-the-device-groups
Information om hur du anger enhetsgrupperna som visas i emulatorns enhetslista finns i Ange enhetsgrupper.
Länka platsen till de angivna enhetsgrupperna link-your-site-to-the-specified-device-groups
Om du vill inkludera emulatorn måste du länka din plats till enhetsgrupperna. Se Lägga till enhetslistan (för både det klassiska och pekoptimerade användargränssnittet).
Aktivera layoutläge för webbplatsen activate-layout-mode-for-your-site
Dessa procedurer används för att aktivera Layout läge på din webbplats.
Konfigurera brytpunkterna configure-the-breakpoints
-
Används i responsiv design.
-
Kan definieras:
- På sidmallen, varifrån inställningarna kopieras till alla sidor som skapas med den mallen.
- På sidnoden, varifrån inställningarna ärvs av underordnade sidor.
-
Definiera en titel och en bredd:
- Titeln beskriver den generiska enhetsgrupperingen, med orientering om så krävs. till exempel telefon, surfplatta, bordslandskap.
- Bredden definierar den maximala bredden i pixlar för den allmänna enhetsgrupperingen. Om till exempel brytpunktstelefonen har en bredd på 768 är det den maximala bredden för den layout som används för en telefonenhet.
-
Är synliga som markörer högst upp i sidredigeraren när du använder emulatorn.
-
Ärvs från den överordnade nodhierarkin och kan åsidosättas när som helst.
-
Det finns en standardbrytpunkt som täcker allt ovanför den sista konfigurerad brytpunkt.
De kan definieras med CRXDE Lite eller XML.
- du behöver lägga till brytpunkter i mallarna.
- lägga till brytpunkter i mallar
- lägga till samma brytpunkter på befintliga sidor
När arv används kan du begränsa detta till innehållets rotsida.
Konfigurera brytpunkter med CRXDE Lite configuring-breakpoints-using-crxde-lite
-
Använd CRXDE Lite (eller motsvarande) för att navigera till:
- Din malldefinition.
- The
jcr:content
sidans nod.
-
Under
jcr:content
skapa noden:- Namn:
cq:responsive
- Typ:
nt:unstructured
- Namn:
-
Skapa noden här:
- Namn:
breakpoints
- Typ:
nt:unstructured
- Namn:
-
Under brytpunktsnoden kan du skapa valfritt antal brytpunkter. Varje definition är en enda nod med följande egenskaper:
- Namn:
<descriptive name>
- Typ:
nt:unstructured
- Titel:
String
*<descriptive title seen in Emulator>
* - Bredd:
Decimal
*<value of breakpoint>
*
- Namn:
Konfigurera brytpunkter med XML configuring-breakpoints-using-xml
Brytpunkterna finns innanför <jcr:content>
i .context.html
under lämplig mallmapp (eller innehållsmapp).
En exempeldefinition:
<cq:responsive jcr:primaryType="nt:unstructured">
<breakpoints jcr:primaryType="nt:unstructured">
<phone jcr:primaryType="nt:unstructured" title="{String}Phone" width="{Decimal}768"/>
<tablet jcr:primaryType="nt:unstructured" title="{String}Tablet" width="{Decimal}1200"/>
</breakpoints>
</cq:responsive>
Lägg till en leverantör av responsiv information add-a-responsive-information-provider
Kopiera följande cq:infoProviders
nodstruktur i den överordnade sidkomponenten:
/libs/foundation/components/page/cq:infoProviders/responsive
Aktivera komponentstorleksändring för sidan enable-component-resizing-for-the-page
Dessa procedurer krävs så att du kan ändra storlek på komponenter i Layout läge.
Ange layoutbehållare som huvudparsys set-layout-container-as-main-parsys
Om du vill ange att huvudparsytan på sidan ska vara en layoutbehållare måste du definiera parametrarna som:
wcm/foundation/components/responsivegrid
I något av följande:
- Sidkomponent
- Sidmall (för framtida bruk)
I följande två exempel visas definitionen:
-
HTML:
code language-xml <sly data-sly-resource="${'par' @ resourceType='wcm/foundation/components/responsivegrid'}/>
-
JSP:
code language-none <cq:include path="par" resourceType="wcm/foundation/components/responsivegrid" />
Inkludera responsiv CSS include-the-responsive-css
CSS för brytpunkter med LESS css-for-breakpoints-using-less
AEM använder LESS för att generera delar av den CSS som behövs, och dessa måste inkluderas i dina projekt.
Du måste också skapa en klientbibliotek för att tillhandahålla ytterligare konfigurations- och funktionsanrop. Följande LESS-extrakt är ett exempel på det minsta du behöver lägga till i ditt projekt:
@import (once) "/libs/wcm/foundation/clientlibs/grid/grid_base.less";
/* maximum amount of grid cells to be provided */
@max_col: 12;
/* default breakpoint */
.aem-Grid {
.generate-grid(default, @max_col);
}
/* phone breakpoint */
@media (max-width: 768px) {
.aem-Grid {
.generate-grid(phone, @max_col);
}
}
/* tablet breakpoint */
@media (min-width: 769px) and (max-width: 1200px) {
.aem-Grid {
.generate-grid(tablet, @max_col);
}
}
Basrutnätsdefinitionen finns under:
/libs/wcm/foundation/clientlibs/grid/grid_base.less
Fundera på formatering styling-considerations
Storleken på komponenter som finns i en responsiv behållare ändras (tillsammans med deras respektive HTML DOM-element) enligt den responsiva stödrasterstorleken. Därför bör du under dessa omständigheter undvika (eller uppdatera) definitioner av DOM-element med fast bredd (som finns).
Till exempel:
-
Före:
width=100px
-
Efter:
max-width=100px
Storleksändring och adaptiv bildkompatibilitet resizing-and-adaptive-image-compliance
Om du ändrar storlek på en komponent i rutnätet utlöses följande avlyssnare om det är lämpligt:
-
beforeedit
-
beforechildedit
-
afteredit
-
afterchildedit
Om du vill ändra storlek på och uppdatera innehållet i en adaptiv bild som ingår i ett responsivt rutnät måste du lägga till en afterEdit
ange till REFRESH_PAGE
avlyssnare i EditConfig
fil för alla ingående komponenter.
Till exempel:
<cq:listeners jcr:primaryType="cq:EditListenersConfig" afteredit="REFRESH_PAGE" />
Den adaptiva bildmekanismen görs tillgänglig via ett skript som styr valet av rätt bild för fönstrets aktuella storlek. Den aktiveras när DOM är redo eller när en dedikerad händelse tas emot. För närvarande måste sidan uppdateras för att korrekt återspegla resultatet av användarens åtgärd.
Aktivera layoutbehållarkomponenten för sidan enable-the-layout-container-component-for-page
Med dessa uppgifter kan författare dra instanser av Layoutbehållare på sidan.
Aktivera layoutbehållarkomponenten för sidredigering enable-the-layout-container-component-for-page-editing
Om du vill att författare ska kunna lägga till fler responsiva rutnät på innehållssidorna måste du aktivera layoutbehållarkomponenten för sidan. Du kan göra detta med:
-
Författarmiljö
Använd Designläge för att aktivera Lagerbehållare -komponent för en sida.
-
Komponentdefinition
Använd
allowedComponent
eller en statisk include när komponenten definieras.
Konfigurera stödrastret för layoutbehållaren configure-the-grid-of-the-layout-container
Du kan konfigurera antalet kolumner som är tillgängliga för varje särskild instans av layoutbehållaren:
-
Författarmiljö
Du kan konfigurera antalet kolumner som är tillgängliga för varje enskild instans av layoutbehållaren.
Om du vill göra det använder du Designlägeöppnar du sedan designdialogrutan för önskad behållare. Här kan du ange hur många kolumner som ska vara tillgängliga för placering och storleksändring. Standardvärdet är 12.
-
XML
Definitioner för det responsiva rutnätet anges i:
etc/design/<*your-project-name*>/.content.xml
Följande parametrar kan definieras:
-
Antal tillgängliga kolumner:
columns="{String}8"
-
Komponenter som kan läggas till i den aktuella komponenten:
components="[/libs/wcm/foundation/components/responsivegrid, ...
-