Basisstructuur scaffolding
Soms moet u een grote set pagina's maken die dezelfde structuur hebben maar andere inhoud hebben. Via de standaardinstelling voor AEM moet u elke pagina maken, de juiste componenten naar de pagina slepen en elk van de pagina's afzonderlijk invullen.
Met een basisstructuur kunt u een formulier (een basisblad) maken met velden die de gewenste structuur voor uw pagina's weerspiegelen. Met dit formulier kunt u eenvoudig pagina's maken op basis van deze structuur.
Hoe structuur werkt how-scaffolding-works
Basispagina's worden opgeslagen in de Gereedschappen console van de sitebeheerder.
-
Open de Gereedschappen console en klik op Standaardpaginascheiding.
-
Onder deze klik klikt u op geometrixx.
-
Onder geometrixx u vindt een basispagina gebeld Nieuws. Dubbelklik om deze pagina te openen.
Het subformulier bestaat uit een formulier met een veld voor elk stuk inhoud dat de pagina zal vormen die moet worden gemaakt en vier belangrijke parameters die via het Pagina-eigenschappen van de basispagina.
De basispagina-eigenschappen zijn:
-
Titeltekst: Dit is de naam van deze basispagina zelf. In dit voorbeeld heet het "Nieuws".
-
Beschrijving: Dit wordt onder de titel op de basispagina weergegeven.
-
Doelsjabloon: Dit is de sjabloon die dit subbestand gebruikt wanneer het een nieuwe pagina maakt. In dit voorbeeld is het een Geometrixinhouds pagina sjabloon.
-
Doelpad: Dit is het pad van de bovenliggende pagina waaronder dit subbestand nieuwe pagina's maakt. In dit voorbeeld is het pad /content/geometrixx/nl/news.
Het lichaam van het substraat is de vorm. Wanneer een gebruiker een pagina wil maken met het subformulier, vult hij het formulier in en klikt u op Maken, onderaan. In de Nieuws Het voorbeeld boven het formulier heeft de volgende velden:
-
Titel: Dit is de naam van de pagina die moet worden gemaakt. Dit veld is altijd aanwezig op elk substraat.
-
Tekst: Dit veld komt overeen met een tekstcomponent op de resulterende pagina.
-
Afbeelding: Dit veld komt overeen met een afbeeldingscomponent op de resulterende pagina.
-
Afbeelding/Geavanceerd: Titel: De titel van de afbeelding.
-
Afbeelding/Geavanceerd: Alt-tekst: De alt-tekst voor de afbeelding.
-
Afbeelding/Geavanceerd: Beschrijving: De beschrijving van de afbeelding.
-
Afbeelding/Geavanceerd: Grootte: De grootte van de afbeelding.
-
Tags/trefwoorden: Metagegevens die aan deze pagina moeten worden toegewezen. Dit veld is altijd aanwezig op elk substraat.
Een stapel maken creating-a-scaffold
Als u een nieuw subformulier wilt maken, gaat u naar de Gereedschappen console, dan Standaardpaginascheiding en maak een nieuwe pagina. Er is één paginasjabloontype beschikbaar, namelijk Basisstructuursjabloon.
Ga naar de Pagina-eigenschappen van de nieuwe pagina en stel de Titeltekst , Beschrijving , Doelsjabloon en Doelpad , zoals hierboven beschreven.
*Vervolgens moet u de structuur definiëren van de pagina die dit subbestand maakt. Hiervoor gaat u naar de ontwerpmodus op de basispagina. Er wordt een koppeling weergegeven waarmee u het subformulier in het dialoogvenster dialoogeditor.
In de dialoogeditor geeft u de eigenschappen op die worden gemaakt wanneer een nieuwe pagina wordt gemaakt met dit subbestand.
De dialoogdefinitie van een subformulier werkt op dezelfde manier als een component (zie Componenten). Er zijn echter enkele belangrijke verschillen van toepassing:
- Componentdialoogdefinities worden weergegeven als normale dialoogvensters (zoals bijvoorbeeld in het middelste venster van de dialoogvenster-editor), terwijl definities van de subdialoogvensters, hoewel deze als normale dialoogvensters in de dialoogeditor worden weergegeven, op de basispagina worden weergegeven als een subformulier (zoals in het dialoogvenster Nieuws hierboven).
- De dialoogvensters van de component verstrekken gebieden voor slechts die waarden nodig om de inhoud van één enkele specifieke component te bepalen. Een basisdialoogvenster moet velden bevatten voor elke eigenschap in elke alinea van de pagina die moet worden gemaakt.
- In het geval van componentdialoogvensters is de component die wordt gebruikt om de opgegeven inhoud te renderen impliciet en daarom is de component
sling:resourceType
wordt automatisch ingevuld wanneer de alinea wordt gemaakt. Met een subformulier moet alle informatie die zowel de inhoud als het toegewezen onderdeel voor een bepaalde alinea definieert, door het dialoogvenster zelf worden verstrekt. In basisdialoogvensters moet deze informatie worden verstrekt door Verborgen velden om deze informatie te verzenden bij het maken van pagina's.
Een blik bij het voorbeeld Nieuws het subold-dialoogvenster in de dialoogeditor helpt u uit te leggen hoe dit werkt. Ga naar de ontwerpmodus op de basispagina en klik op de koppeling voor de dialoogeditor.
Klik nu op het dialoogvenster Dialog > Tab Panel > Text > Text, als volgt:
De eigenschappenlijst voor dit veld wordt als volgt weergegeven aan de rechterkant van de dialoogeditor:
Let op de eigenschap name voor dit veld. Het heeft de waarde
./jcr:content/par/text/text
Dit is de naam van de eigenschap waarnaar de inhoud van dit veld wordt geschreven wanneer het subbestand wordt gebruikt om een pagina te maken. De eigenschap wordt gedeclareerd als een relatief pad van het knooppunt dat staat voor de pagina die moet worden gemaakt. Hiermee wordt de eigenschapstekst onder de nodetekst opgegeven. Deze bevindt zich onder de nodepari, die zelf een onderliggend item is van het knooppunt jcr:content onder het paginaknooppunt.
Hiermee bepaalt u de locatie van de opslag van de inhoud voor de tekst die in dit veld wordt ingevoerd. Voor deze inhoud moeten echter nog twee kenmerken worden vastgesteld:
- Het feit dat de tekenreeks die hier wordt opgeslagen, moet worden geïnterpreteerd als rijke tekst, en
- welke component moet worden gebruikt om deze inhoud weer te geven op de resulterende pagina.
Let op: in een normaal componentdialoogvenster hoeft u deze informatie niet op te geven omdat dit impliciet is in het feit dat het dialoogvenster al is gebonden aan een specifieke component.
Als u deze twee gegevens wilt opgeven, gebruikt u verborgen velden. Klik op het eerste verborgen veld Dialog > Tab Panel > Text > Hidden, als volgt:
De eigenschappen van dit verborgen veld zijn als volgt:
De eigenschap name van dit verborgen veld is
./jcr:content/par/text/textIsRich
Dit is een Booleaanse eigenschap die wordt gebruikt om de tekstreeks te interpreteren die is opgeslagen op ./jcr:content/par/text/text.
Omdat we weten dat de tekst moet worden geïnterpreteerd als een rijke tekst, specificeren we de value
eigenschap van dit veld als true
.
Het tweede verborgen veld is zichtbaar door er als volgt op te klikken:
De eigenschappen van dit verborgen veld zijn als volgt:
De eigenschap name van dit verborgen veld is
./jcr:content/par/text/sling:resourceType
en de vaste waarde die voor deze eigenschap is opgegeven, is
foundation/components/textimage
"This specifies that component to be used to render the text content of this paragraph is the Tekstafbeelding component. Met de isRichText
Booleaanse waarde die in het andere verborgen veld is opgegeven, kan de component de werkelijke tekstreeks renderen die is opgeslagen op ./jcr:content/par/text/text
op de gewenste manier.
Basisstructuur met MSM-overerving scaffolding-with-msm-inheritance
In de klassieke UI, is het steigeren volledig geïntegreerd met overerving MSM (indien van toepassing).
Wanneer u een pagina opent in Basisstructuur in de modus (met het pictogram onder aan sidekick) worden componenten die overerving ondergaan, aangeduid met:
- een slotsymbool (voor de meeste onderdelen); bijv. tekst en titel)
- een masker met de tekst Klik om overerving te annuleren (voor afbeeldingscomponenten)
Hierin ziet u dat de component niet kan worden bewerkt, totdat de overerving wordt geannuleerd.
Als u op het vergrendelingssymbool of het afbeeldingspictogram klikt, kunt u de overerving verbreken:
- het symbool verandert in een open hangslot .
- als de vergrendeling eenmaal is opgeheven, kunt u de inhoud bewerken.
Na ontgrendelen kunt u de overerving herstellen door op het ontgrendelde hangslotsymbool te klikken. Alle bewerkingen die u hebt aangebracht, gaan hierdoor verloren.