Conceptos básicos de componentes component-basics

En este capítulo, vamos a explorar la tecnología subyacente de un componente de sitios de Adobe Experience Manager AEM () mediante un ejemplo sencillo de HelloWorld. Se realizan pequeñas modificaciones en un componente existente, que cubren temas de creación, HTL, modelos Sling y bibliotecas del lado del cliente.

Requisitos previos prerequisites

Revise las herramientas y las instrucciones necesarias para configurar un entorno de desarrollo local.

AEM El IDE usado en los vídeos es Visual Studio Code y el complemento VSCode Sync de la sincronización de códigos de.

Objetivo objective

  1. Aprenda la función que desempeñan las plantillas HTL y los modelos Sling para procesar dinámicamente el HTML.
  2. Descubra cómo se utilizan los cuadros de diálogo para facilitar la creación de contenido.
  3. Conozca los conceptos básicos de las bibliotecas del lado del cliente para incluir CSS y JavaScript para admitir un componente.

Lo que va a generar what-build

En este capítulo, se realizan varias modificaciones en un componente HelloWorld simple. AEM Al realizar actualizaciones en el componente HelloWorld, aprenderá sobre las áreas clave del desarrollo de componentes de la.

Proyecto de inicio de capítulo starter-project

AEM Este capítulo se basa en un proyecto genérico generado por el Arquetipo de proyecto de la. Vea el siguiente vídeo y revise los requisitos previos para comenzar.

NOTE
Si ha completado correctamente el capítulo anterior, puede volver a utilizar el proyecto y omitir los pasos para desproteger el proyecto de inicio.

Abra un nuevo terminal de línea de comandos y realice las siguientes acciones.

  1. En un directorio vacío, clone el repositorio aem-guides-wknd:

    code language-shell
    $ git clone git@github.com:adobe/aem-guides-wknd.git --branch tutorial/component-basics-start --single-branch
    
    note note
    NOTE
    Opcionalmente, puede seguir utilizando el proyecto generado en el capítulo anterior, Configuración del proyecto.
  2. Vaya a la carpeta aem-guides-wknd.

    code language-shell
    $ cd aem-guides-wknd
    
  3. AEM Genere e implemente el proyecto en una instancia local de con el siguiente comando:

    code language-shell
    $ mvn clean install -PautoInstallSinglePackage
    
    note note
    NOTE
    AEM Si utiliza la versión 6.5 o 6.4 de la aplicación, anexe el perfil classic a cualquier comando de Maven.
    code language-shell
    $ mvn clean install -PautoInstallSinglePackage -Pclassic
    
  4. Importe el proyecto en su IDE preferido siguiendo las instrucciones para configurar un entorno de desarrollo local.

Creación de componentes component-authoring

Los componentes se pueden considerar como pequeños componentes modulares de una página web. Para reutilizar componentes, estos deben poder configurarse. Esto se realiza a través del cuadro de diálogo de autor. AEM A continuación, vamos a crear un componente simple e inspeccionar cómo se conservan los valores del cuadro de diálogo en los puntos de vista de la interfaz de usuario de la interfaz de usuario de la.

A continuación se muestran los pasos de alto nivel realizados en el vídeo anterior.

  1. Cree una página con el nombre Conceptos básicos del componente debajo del sitio WKND > US > en.
  2. Agregue el Componente Hello World a la página recién creada.
  3. Abra el cuadro de diálogo del componente e introduzca un texto. Guarde los cambios para ver el mensaje que se muestra en la página.
  4. Cambie al modo de desarrollador y vea la ruta de contenido en CRXDE-Lite e inspeccione las propiedades de la instancia del componente.
  5. Use CRXDE-Lite para ver el script cq:dialog y helloworld.html de /apps/wknd/components/content/helloworld.

Lenguaje de plantilla de HTML (HTL) y cuadros de diálogo htl-dialogs

El lenguaje de plantilla HTML AEM HTL es un lenguaje ligero de creación de plantillas en el lado del servidor que utilizan los componentes de la plantilla para procesar contenido.

Diálogos definen las configuraciones disponibles que se pueden realizar para un componente.

A continuación, vamos a actualizar el script HTL HelloWorld para mostrar un saludo adicional antes del mensaje de texto.

A continuación se muestran los pasos de alto nivel realizados en el vídeo anterior.

  1. Cambie al IDE y abra el proyecto en el módulo ui.apps.

  2. Abra el archivo helloworld.html y actualice el marcado del HTML.

  3. AEM AEM Use herramientas IDE como VSCodeSincronización de la sincronización de la sincronización de la sincronización de la sincronización de la sincronización de archivos con la instancia de la sincronización local de la.

  4. Vuelva al explorador y observe que el procesamiento del componente ha cambiado.

  5. Abra el archivo .content.xml que define el cuadro de diálogo para el componente HelloWorld en:

    code language-plain
    <code>/aem-guides-wknd/ui.apps/src/main/content/jcr_root/apps/wknd/components/helloworld/_cq_dialog/.content.xml
    
  6. Actualice el cuadro de diálogo para agregar un campo de texto adicional denominado Title con el nombre ./title:

    code language-xml
    <?xml version="1.0" encoding="UTF-8"?>
    <jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:cq="http://www.day.com/jcr/cq/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0"
        jcr:primaryType="nt:unstructured"
        jcr:title="Properties"
        sling:resourceType="cq/gui/components/authoring/dialog">
        <content
            jcr:primaryType="nt:unstructured"
            sling:resourceType="granite/ui/components/coral/foundation/fixedcolumns">
            <items jcr:primaryType="nt:unstructured">
                <column
                    jcr:primaryType="nt:unstructured"
                    sling:resourceType="granite/ui/components/coral/foundation/container">
                    <items jcr:primaryType="nt:unstructured">
                        <title
                            jcr:primaryType="nt:unstructured"
                            sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
                            fieldLabel="Title"
                            name="./title"/>
                        <text
                            jcr:primaryType="nt:unstructured"
                            sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
                            fieldLabel="Text"
                            name="./text"/>
                    </items>
                </column>
            </items>
        </content>
    </jcr:root>
    
  7. Vuelva a abrir el archivo helloworld.html, que representa el script HTL principal responsable de procesar el componente HelloWorld desde la siguiente ruta:

    code language-plain
        <code>/aem-guides-wknd.ui.apps/src/main/content/jcr_root/apps/wknd/components/helloworld/helloworld.html
    
  8. Actualice helloworld.html para representar el valor del campo de texto Saludo como parte de una etiqueta H1:

    code language-html
    <div class="cmp-helloworld" data-cmp-is="helloworld">
        <h1 class="cmp-helloworld__title">${properties.title}</h1>
        ...
    </div>
    
  9. AEM Implemente los cambios en una instancia local de con el complemento para desarrolladores o con sus habilidades con Maven.

Modelos Sling sling-models

Los modelos Sling son objetos Java™ "POJO" (Plain Old Java™ Objects) impulsados por anotaciones que facilitan la asignación de datos de las variables JCR a Java™. AEM También proporcionan varias otras sutilezas cuando se desarrollan en el contexto de la.

A continuación, vamos a realizar algunas actualizaciones en el modelo Sling HelloWorldModel para aplicar lógica empresarial a los valores almacenados en el JCR antes de enviarlos a la página.

  1. Abra el archivo HelloWorldModel.java, que es el modelo Sling utilizado con el componente HelloWorld.

    code language-plain
    <code>/aem-guides-wknd.core/src/main/java/com/adobe/aem/guides/wknd/core/models/HelloWorldModel.java
    
  2. Añada las siguientes instrucciones de importación:

    code language-java
    import org.apache.commons.lang3.StringUtils;
    import org.apache.sling.models.annotations.DefaultInjectionStrategy;
    
  3. Actualizar la anotación @Model para usar un DefaultInjectionStrategy:

    code language-java
    @Model(adaptables = Resource.class,
       defaultInjectionStrategy = DefaultInjectionStrategy.OPTIONAL)
       public class HelloWorldModel {
       ...
    
  4. Agregue las líneas siguientes a la clase HelloWorldModel para asignar los valores de las propiedades JCR del componente title y text a las variables Java™:

    code language-java
    ...
    @Model(adaptables = Resource.class,
    defaultInjectionStrategy = DefaultInjectionStrategy.OPTIONAL)
    public class HelloWorldModel {
    
        ...
    
        @ValueMapValue
        private String title;
    
        @ValueMapValue
        private String text;
    
        @PostConstruct
        protected void init() {
            ...
    
  5. Agregue el siguiente método getTitle() a la clase HelloWorldModel, que devuelve el valor de la propiedad denominada title. Este método agrega la lógica adicional para devolver un valor de cadena de "Valor predeterminado aquí". si la propiedad title es nula o está en blanco:

    code language-java
    /***
    *
    * @return the value of title, if null or blank returns "Default Value here!"
    */
    public String getTitle() {
        return StringUtils.isNotBlank(title) ? title : "Default Value here!";
    }
    
  6. Agregue el siguiente método getText() a la clase HelloWorldModel, que devuelve el valor de la propiedad denominada text. Este método transforma la cadena en todos los caracteres en mayúsculas.

    code language-java
        /***
        *
        * @return All caps variation of the text value
        */
    public String getText() {
        return StringUtils.isNotBlank(this.text) ? this.text.toUpperCase() : null;
    }
    
  7. Genere e implemente el paquete desde el módulo core:

    code language-shell
    $ cd core
    $ mvn clean install -PautoInstallBundle
    
    note note
    NOTE
    AEM Para el uso de 6.4/6.5 de mvn clean install -PautoInstallBundle -Pclassic
  8. Actualice el archivo helloworld.html en aem-guides-wknd.ui.apps/src/main/content/jcr_root/apps/wknd/components/content/helloworld/helloworld.html para utilizar los métodos recién creados del modelo HelloWorld.

    Se crea una instancia del modelo HelloWorld para esta instancia de componente mediante la directiva HTL: data-sly-use.model="com.adobe.aem.guides.wknd.core.models.HelloWorldModel", guardando la instancia en la variable model.

    La instancia del modelo HelloWorld ahora está disponible en HTL a través de la variable model usando HelloWord. Estas invocaciones a métodos pueden utilizar sintaxis de método abreviada, por ejemplo: ${model.getTitle()} se puede abreviar como ${model.title}.

    Del mismo modo, todos los scripts HTL se insertan con objetos globales a los que se puede acceder mediante la misma sintaxis que los objetos del modelo Sling.

    code language-html
    <div class="cmp-helloworld" data-cmp-is="helloworld"
        data-sly-use.model="com.adobe.aem.guides.wknd.core.models.HelloWorldModel">
        <h1 class="cmp-helloworld__title">${model.title}</h1>
        <div class="cmp-helloworld__item" data-sly-test="${properties.text}">
            <p class="cmp-helloworld__item-label">Text property:</p>
            <pre class="cmp-helloworld__item-output" data-cmp-hook-helloworld="property">${properties.text}</pre>
        </div>
        <div class="cmp-helloworld__item" data-sly-test="${model.text}">
            <p class="cmp-helloworld__item-label">Sling Model getText() property:</p>
            <pre class="cmp-helloworld__item-output" data-cmp-hook-helloworld="property">${model.text}</pre>
        </div>
    </div>
    
  9. AEM Implemente los cambios en una instancia local de con el complemento Eclipse Developer o con sus habilidades con Maven.

Bibliotecas del cliente client-side-libraries

Las bibliotecas del cliente clientlibs, para abreviar, proporcionan un mecanismo para organizar y administrar los archivos CSS y JavaScript necesarios para una implementación de AEM Sites. Las bibliotecas del lado del cliente son la forma estándar de incluir CSS y JavaScript AEM en una página de, como se muestra a continuación en el código de tiempo de la página de.

El módulo ui.frontend es un proyecto webpack desacoplado que está integrado en el proceso de compilación. Esto permite el uso de bibliotecas de front-end populares como Sass, LESS y TypeScript. El módulo ui.frontend se explora con más detalle en el capítulo Bibliotecas del cliente.

A continuación, actualice los estilos CSS para el componente HelloWorld.

A continuación se muestran los pasos de alto nivel realizados en el vídeo anterior.

  1. Abra una ventana de terminal y vaya al directorio ui.frontend

  2. Al estar en el directorio ui.frontend, ejecute el comando npm install npm-run-all --save-dev para instalar el módulo de nodo npm-run-all. AEM Este paso es necesario en el tipo de archivo 39 generado por el proyecto de la; en la próxima versión del tipo de archivo, esto no es necesario.

  3. A continuación, ejecute el comando npm run watch:

    code language-shell
    $ npm run watch
    
  4. Cambie al IDE y abra el proyecto en el módulo ui.frontend.

  5. Abra el archivo ui.frontend/src/main/webpack/components/_helloworld.scss.

  6. Actualice el archivo para mostrar un título rojo:

    code language-scss
    .cmp-helloworld {}
    .cmp-helloworld__title {
        color: red;
    }
    
  7. AEM En el terminal, debería ver la actividad que indica que el módulo ui.frontend está compilando y sincronizando los cambios con la instancia local de la.

    code language-shell
    Entrypoint site 214 KiB = clientlib-site/site.css 8.45 KiB clientlib-site/site.js 206 KiB
    2022-02-22 17:28:51: webpack 5.69.1 compiled successfully in 119 ms
    change:dist/index.html
    + jcr_root/apps/wknd/clientlibs/clientlib-site/css/site.css
    + jcr_root/apps/wknd/clientlibs/clientlib-site/css
    + jcr_root/apps/wknd/clientlibs/clientlib-site/js/site.js
    + jcr_root/apps/wknd/clientlibs/clientlib-site/js
    + jcr_root/apps/wknd/clientlibs/clientlib-site
    + jcr_root/apps/wknd/clientlibs/clientlib-dependencies/css.txt
    + jcr_root/apps/wknd/clientlibs/clientlib-dependencies/js.txt
    + jcr_root/apps/wknd/clientlibs/clientlib-dependencies
    
  8. Vuelva al explorador y observe que el color del título ha cambiado.

    Actualización de conceptos básicos del componente

Enhorabuena. congratulations

¡Felicidades, ha aprendido los conceptos básicos del desarrollo de componentes en Adobe Experience Manager!

Siguientes pasos next-steps

Familiarícese con las páginas y plantillas de Adobe Experience Manager en el siguiente capítulo Páginas y plantillas. Comprenda cómo los componentes principales se procesan como proxy en el proyecto y aprenda configuraciones de directiva avanzadas de plantillas editables para crear una plantilla de página de artículo bien estructurada.

Vea el código terminado en GitHub o revise e implemente el código localmente en la rama Git tutorial/component-basics-solution.

recommendation-more-help
b2a561c1-47c0-4182-b8c1-757a197484f9