Desarrollo para la diferencia de página

Este vídeo muestra cómo proporcionar estilos personalizados para la funcionalidad de diferencia de página de AEM Sites.

Personalización de estilos de diferencia de página

NOTA

Este vídeo añade CSS personalizada a la biblioteca de cliente de we.Retail, donde como estos cambios deben realizarse en el proyecto AEM Sites del cliente; en el código de ejemplo siguiente: my-project.

AEM diferencia de página obtiene la CSS OOTB mediante una carga directa de /libs/cq/gui/components/common/admin/diffservice/clientlibs/diffservice/css/htmldiff.css.

Debido a esta carga directa de CSS en lugar de usar una categoría de biblioteca de cliente, debemos encontrar otro punto de inyección para los estilos personalizados, y este punto de inyección personalizado es la clientlib de creación del proyecto.

Esto tiene la ventaja de permitir que estas anulaciones de estilo personalizadas sean específicas del inquilino.

Preparación de la clientlib de creación

Garantizar la existencia de un authoring clientlib para su proyecto en /apps/my-project/clientlib/authoring.

<?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]"/>

Proporcionar una CSS personalizada

Agregue al authoring clientlib a css.txt que señala al archivo menor que proporcionará los estilos de anulación. Menos es preferible debido a sus muchas funciones prácticas, incluido el ajuste de clases que se aprovecha en este ejemplo.

base=./css

htmldiff.less

Cree la variable less que contiene las anulaciones de estilo en /apps/my-project/clientlibs/authoring/css/htmldiff.lessy proporcione los estilos de superposición según sea necesario.

/* 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;
    }
}

Incluya la CSS clientlib de creación a través del componente de página

Incluya la categoría clientlibs de creación en la página base del proyecto /apps/my-project/components/structure/page/customheaderlibs.html directamente antes de la </head> para asegurarse de que se cargan los estilos.

Estos estilos deben limitarse a Editar y vista previa modos WCM.

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

El resultado final de una página de comparación de diferencias con los estilos aplicados anteriores tendría este aspecto (se ha añadido el HTML y se ha cambiado el componente).

Diferencia de página