Entwicklung für Seitenunterschiede

In diesem Video wird gezeigt, wie Sie benutzerdefinierte Stile für die Seitenunterschiede-Funktion von AEM Sites bereitstellen.

Anpassen der Seitendifferenz-Stile

HINWEIS

In diesem Video wird der Client-Bibliothek "we.Retail"benutzerdefiniertes CSS hinzugefügt, wobei diese Änderungen am AEM Sites-Projekt des Anpassers vorgenommen werden sollten. im folgenden Beispielcode: my-project.

AEM Seitendifferenz ruft die OOTB-CSS über eine direkte Last von /libs/cq/gui/components/common/admin/diffservice/clientlibs/diffservice/css/htmldiff.css ab.

Aufgrund dieser direkten Belastung von CSS anstatt einer Client-Bibliothekskategorie müssen wir einen weiteren Einfügepunkt für die benutzerdefinierten Stile finden. Dieser benutzerdefinierte Einfügepunkt ist die Authoring-Client-Bibliothek des Projekts.

Dies hat den Vorteil, dass diese benutzerdefinierten Stilüberschreibungen mandantenspezifisch sein können.

Vorbereiten der Authoring-Client-Bibliothek

Stellen Sie sicher, dass eine authoring clientlib für Ihr Projekt unter /apps/my-project/clientlib/authoring. vorhanden ist.

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:cq="http://www.day.com/jcr/cq/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0"
        jcr:primaryType="cq:ClientLibraryFolder"
        categories="[my-project.authoring]"/>

Bereitstellen des benutzerdefinierten CSS

Fügen Sie der clientlib des Projekts authoring eine css.txt hinzu, die auf die Datei less verweist, die die übergeordneten Stile bereitstellt. 🔗 Lessis wird aufgrund seiner vielen praktischen Funktionen bevorzugt, darunter auch das Klassenwrapping, das in diesem Beispiel verwendet wird.

base=./css

htmldiff.less

Erstellen Sie die less-Datei, die die Stilüberschreibungen unter /apps/my-project/clientlibs/authoring/css/htmldiff.less enthält, und stellen Sie nach Bedarf die übergeordneten Stile bereit.

/* Wrap with body to gives these rules more specificity than the OOTB */
body {

    /* .html-XXXX are the styles that wrap text that has been added or removed */

    .html-added {
        background-color: transparent;
     color: initial;
        text-decoration: none;
     border-bottom: solid 2px limegreen;
    }

    .html-removed {
        background-color: transparent;
     color: initial;
        text-decoration: none;
     border-bottom: solid 2px red;
    }

    /* .cq-component-XXXX require !important as the class these are overriding uses it. */

    .cq-component-changed {
        border: 2px dashed #B9DAFF !important;
        border-radius: 8px;
    }
    
    .cq-component-moved {
        border: 2px solid #B9DAFF !important;
        border-radius: 8px;
    }

    .cq-component-added {
        border: 2px solid #CCEBB8 !important;
        border-radius: 8px;
    }

    .cq-component-removed {
        border: 2px solid #FFCCCC !important;
        border-radius: 8px;
    }
}

Fügen Sie die clientlib-CSS für die Bearbeitung über die Seitenkomponente ein.

Fügen Sie die Kategorie "Authoring-Client-Bibliotheken"direkt vor dem Tag </head> auf der Basisseite des Projekts ein, um sicherzustellen, dass die Stile geladen werden./apps/my-project/components/structure/page/customheaderlibs.html

Diese Stile sollten auf die WCM-Modi Bearbeiten und Vorschau beschränkt sein.

<head>
  ...
  <sly data-sly-test="${wcmmode.preview || wcmmode.edit}" 
       data-sly-call="${clientLib.css @ categories='my-project.authoring'}"/>
</head>

Das Endergebnis einer diff'd-Seite mit den oben genannten Stilen würde wie folgt aussehen (HTML hinzugefügt und Komponente geändert).

Seitenunterschied