Konfigurera layoutbehållare och layoutläge configuring-layout-container-and-layout-mode
Responsiv layout är en mekanism för att förverkliga 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.
-
Standardkomponenten för Layoutbehållare 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, till exempel för att uppnå kolumnkontroll.
-
-
-
Layoutläge
När layoutbehållaren har placerats på sidan kan du använda layoutläget 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 beroende på 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 den här aktiviteten kan du se den responsiva emulatorn på din plats.
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 Registrera 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 länkar du platsen till enhetsgrupperna. Se Lägga till enhetslistan (för både det klassiska och det pekoptimerade användargränssnittet).
Aktivera layoutläge för webbplatsen activate-layout-mode-for-your-site
Dessa procedurer används för att aktivera layoutläget på din plats.
Konfigurera brytpunkterna configure-the-breakpoints
-
Används i responsiv design.
-
Kan definieras:
- På sidmallen, från vilken 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 allmänna enhetsgrupperingen, med orientering om det behö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 inte finns i lådan) som täcker allt över den senaste konfigurerade brytpunkten.
De kan definieras med CRXDE Lite eller XML.
- lägg 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.
- Sidans
jcr:content
-nod.
-
Skapa noden under
jcr:content
:- 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
Brytpunkter finns i avsnittet <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 till 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 layoutläget.
Ange layoutbehållare som huvudparsys set-layout-container-as-main-parsys
Om du vill ange att huvudparsytan på sidan ska vara en layoutbehållare definierar du parsytorna som:
wcm/foundation/components/responsivegrid
I antingen
- Sidkomponent
- Sidmall (för framtida bruk)
I följande två exempel illustreras 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 ett klientbibliotek för att kunna tillhandahålla ytterligare konfigurations- och funktionsanrop. Följande LESS-extrakt är ett exempel på det minsta som du måste lägga till i projektet:
@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) beroende på stödrastrets responsiva storlek. 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 stödraster måste du lägga till en afterEdit
-uppsättning till REFRESH_PAGE
-avlyssnare i EditConfig
-filen 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 de här åtgärderna kan författare dra instanser av komponenten Layoutbehållare till 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 komponenten Lagerbehållare för en sida.
-
Komponentdefinition
Använd
allowedComponent
eller en statisk include när du definierar komponenten.
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.
Det gör du genom att använda designläget och sedan öppna 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, ...
-