Anpassen der Kernkomponenten customizing-core-components
Die Kernkomponenten implementieren verschiedene Muster, die eine einfache Anpassung ermöglichen, von einfachen Stilen bis hin zur Wiederverwendung erweiterter Funktionen.
Flexible Architektur flexible-architecture
Die Kernkomponenten wurden von Anfang an so entworfen, dass sie flexibel und erweiterbar sind. Ein Überblick über ihre Architektur zeigt an, wo Anpassungen vorgenommen werden können.
- Im Dialogfeld „Design“ wird definiert, was Autoren im Dialogfeld „Bearbeiten“ tun können und was nicht.
- Das Dialogfeld „Bearbeiten“ zeigt Autoren nur die Optionen an, die sie verwenden dürfen.
- Das Sling-Modell überprüft und bereitet den Inhalt für die Ansicht (Vorlage) vor.
- Das Ergebnis des Sling-Modells kann für die SPA-Anwendungsfälle in JSON serialisiert werden.
- Das HTL rendert die HTML Server-seitig für die herkömmliche Server-seitige Wiedergabe.
- Die HTML-Ausgabe ist semantisch, barrierefrei, suchmaschinenoptimiert und leicht zu gestalten.
Und alle Kernkomponenten implementieren das Stilsystem.
AEM-Projektarchetyp aem-project-archetype
Der AEM-Projektarchetyp erstellt ein Adobe Experience Manager-Minimalprojekt als Ausgangspunkt für Ihre eigenen Projekte, einschließlich eines Beispiels für eine benutzerdefinierte HTL-Komponente mit SlingModels, um die Logik und ordnungsgemäße Implementierung der Kernkomponenten mit dem empfohlenen Proxy-Muster zu gewährleisten.
Anpassungsmuster customization-patterns
Anpassen von Dialogen customizing-dialogs
Es ist möglicherweise sinnvoll, die in einem Kernkomponentendialogfeld verfügbaren Konfigurationsoptionen anzupassen, entweder im Dialogfeld „Design“ oder im Dialogfeld „Bearbeiten“.
Jedes Dialogfeld hat eine einheitliche Knotenstruktur. Es wird empfohlen, dass diese Struktur in einer inhärenten Komponente repliziert wird, sodass Sling Ressource Merger und Ausblende-Bedingungen genutzt werden können, um Bereiche des Originaldialogs auszublenden, zu ersetzen oder neu anzuordnen. Die zu replizierende Struktur ist als beliebiger Wert bis zur Registerkartenelement-Knotenebene definiert.
Damit alle Änderungen an einem Dialogfeld in seiner aktuellen Version vollständig kompatibel sind, ist es äußerst wichtig, dass Strukturen unterhalb der Registerkartenelementebene nicht angerührt werden (ausgeblendet, hinzugefügt, ersetzt, neu angeordnet usw.). Stattdessen sollte ein übergeordnetes Tab-Element über die Eigenschaft sling:hideResource
ausgeblendet werden (siehe Eigenschaften der Zusammenführung von Sling-Ressourcen) und neue Tab-Elemente hinzugefügt werden, die die maßgeschneiderten Konfigurationsfelder enthalten. sling:orderBefore
kann verwendet werden, um die Registerkartenelemente bei Bedarf neu anzuordnen.
Das folgende Dialogfeld zeigt die empfohlene Dialogfeldstruktur sowie das Ausblenden und Ersetzen einer vererbten Registerkarte wie oben beschrieben:
<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="https://sling.apache.org/jcr/sling/1.0"
xmlns:jcr="https://www.jcp.org/jcr/1.0"
xmlns:nt="https://www.jcp.org/jcr/nt/1.0"
xmlns:granite="https://www.adobe.com/jcr/granite/1.0"
jcr:primaryType="nt:unstructured">
<content jcr:primaryType="nt:unstructured">
<items jcr:primaryType="nt:unstructured">
<tabs jcr:primaryType="nt:unstructured">
<items jcr:primaryType="nt:unstructured">
<originalTab
jcr:primaryType="nt:unstructured"
sling:hideResource="true"/>
<myTab
jcr:primaryType="nt:unstructured"
jcr:title="My Tab"
sling:resourceType="granite/ui/components/coral/foundation/container">
<!-- myTab content -->
</myTab>
</items>
</tabs>
</items>
</content>
</jcr:root>
Anpassen der Logik einer Kernkomponente customizing-the-logic-of-a-core-component
Die Geschäftslogik für die Kernkomponenten ist in Sling-Modellen implementiert. Diese Logik kann mithilfe eines Sling-Delegationsmusters erweitert werden.
Beispielsweise verwendet die Titel-Kernkomponente die jcr:title
-Eigenschaft der angeforderten Ressource, um den Titeltext zu liefern. Wenn keine jcr:title
-Eigenschaft definiert ist, ist eine Ausweichmöglichkeit zum aktuellen Seitentitel implementiert. Wir möchten das Verhalten so ändern, dass der Titel der aktuellen Seite immer angezeigt wird.
Da die Implementierung der Modelle der Kernkomponenten privat ist, müssen sie mit einem Delegationsmuster erweitert werden.
@Model(adaptables = SlingHttpServletRequest.class,
adapters = Title.class,
resourceType = "myproject/components/pageHeadline")
public class PageHeadline implements Title {
@ScriptVariable private Page currentPage;
@Self @Via(type = ResourceSuperType.class)
private Title title;
@Override public String getText() {
return currentPage.getTitle();
}
@Override public String getType() {
return title.getType();
}
}
Weitere Informationen zum Delegierungsmuster finden Sie im GitHub Wiki-Artikel Delegierungsmuster für Sling-Modelle.
Anpassen des Markup customizing-the-markup
Manchmal erfordert erweitertes Formatieren eine andere Markup-Struktur der Komponente.
Hierfür können Sie ganz einfach die zu ändernden HTL-Dateien aus der Kernkomponente in die Proxy-Komponente kopieren.
Wenn Sie das Beispiel der Breadcrumb-Kernkomponente erneut aufrufen, um die Markup-Ausgabe anzupassen, muss die breadcrumb.html
-Datei in die Site-spezifische Komponente kopiert werden, die über ein sling:resourceSuperTypes
verfügt, das auf die Breadcrumb-Kernkomponente zeigt.
Formatieren der Komponenten styling-the-components
Die erste Art der Anpassung besteht darin, CSS-Stile anzuwenden.
Um dies zu vereinfachen, rendern die Kernkomponenten das Semantik-Markup und folgen einer standardisierten Benennungskonvention, die von Bootstrap / inspiriert wurde. Um die Stile für die einzelnen Komponenten einfach zu erreichen und zu benennen, wird jede Kernkomponente in ein DIV-Element mit den Klassen cmp
und cmp-<name>
eingeschlossen.
Betrachtet man beispielsweise die HTL-Datei der v1-Kern-Breadcrumb-Komponente: breadcrumb.html, so ergibt sich eine Hierarchie der ausgegebenen Elemente von ol.breadcrumb > li.breadcrumb-item > a
. Um sicherzustellen, dass eine CSS-Regel nur die Breadcrumb-Klasse dieser Komponente betrifft, sollten alle Regeln in einem Namensbereich angeordnet werden, wie unten dargestellt:
.cmp-breadcrumb .breadcrumb {}
.cmp-breadcrumb .breadcrumb-item {}
.cmp-breadcrumb a {}
Darüber hinaus nutzt jede der Kernkomponenten die AEM-Funktion Style System, mit der Vorlagenautoren zusätzliche CSS-Klassennamen definieren können, die von den Seitenautoren auf die Komponente angewendet werden können. Auf diese Weise können Sie für jede Vorlage eine Liste der zulässigen Komponentenstile definieren und festlegen, ob eine dieser Komponenten standardmäßig auf alle Komponenten dieser Art angewendet werden soll.
Upgrade-Kompatibilität von Anpassungen upgrade-compatibility-of-customizations
Es gibt drei verschiedene Arten von Upgrades:
- Upgrade der AEM-Version
- Upgrade der Kernkomponenten auf eine neue Unterversion
- Upgrade der Kernkomponenten auf eine Hauptversion
Im Allgemeinen wirkt sich ein Upgrade von AEM auf eine neue Version nicht auf die Kernkomponenten oder die vorgenommenen Anpassungen aus, vorausgesetzt, die Komponentenversionen unterstützen auch die neue AEM-Version, auf die migriert wird, und Anpassungen verwenden keine APIs, die veraltet oder entfernt.
Das Aktualisieren der Kernkomponenten ohne Wechseln zu einer neueren Hauptversion sollte sich nicht auf Anpassungen auswirken, solange die auf dieser Seite beschriebenen Anpassungsmuster verwendet werden.
Wechseln zu einer neueren Hauptversion der Kernkomponenten ist nur für die Inhaltsstruktur kompatibel, Anpassungen müssen jedoch möglicherweise überarbeitet werden. Klare Änderungsprotokolle werden für jede Komponentenversion veröffentlicht, um die Änderungen hervorzuheben, die Auswirkungen auf die auf dieser Seite beschriebenen Anpassungen haben.
Unterstützung von Anpassungen support-of-customizations
Wie bei jeder AEM-Komponente gibt es einige Aspekte hinsichtlich der Anpassungen zu beachten:
-
Ändern Sie den Code der Kernkomponenten nie direkt.
Dies würde dazu führen, dass sie nicht vollständig unterstützt werden und künftige Updates der Komponenten zu einem schmerzhaften Prozess machen. Verwenden Sie stattdessen die auf dieser Seite beschriebenen Anpassungsmethoden.
-
Für benutzerdefinierten Code sind Sie selbst verantwortlich.
Unser Support-Programm deckt keinen benutzerdefinierten Code ab und gemeldete Probleme, die nicht mit Vanilla-Kernkomponenten reproduziert werden können, die wie dokumentiert verwendet werden, werden nicht anerkannt.
-
Achten Sie auf veraltete und entfernte Funktionen.
Stellen Sie bei jedem Upgrade jeder neuen AEM-Version sicher, dass alle verwendeten APIs immer aktuell sind, indem Sie die Seite Veraltete und entfernte Funktionen im Auge behalten.
Siehe auch Abschnitt zur Kernkomponentenunterstützung.
Lesen Sie als Nächstes:
- Verwenden von Kernkomponenten - Starten Sie mit Kernkomponenten in Ihrem eigenen Projekt.
- Komponentenrichtlinien - Lernen Sie die Implementierungsmuster der Kernkomponenten kennen.