Bibliotecas de cliente y componentes principales client-libraries

Los componentes principales incluyen una serie de bibliotecas de cliente y permiten incluir las suyas propias.

Bibliotecas de cliente proporcionadas provided

Los componentes principales proporcionan las siguientes bibliotecas de cliente listas para usarse.

  • El sitio clientlibs proporciona el comportamiento funcional minimalista de los componentes que se van a aplicar al sitio.
    • Sirven como punto de partida para acelerar los proyectos, y se alienta a las implementaciones a ampliarlos y personalizarlos para lograr la apariencia y funcionalidad deseadas.
  • Las clientlibs del editor se aplican al cuadro de diálogo de creación para garantizar su funcionalidad y aspecto esperados.
  • Las clientlibs editorhook se aplican al sitio cuando se cargan en modo de edición.
    • Contienen código JavaScript ejecutado en eventos activados por el editor, lo que facilita la inicialización de la funcionalidad dinámica.
  • Algunos componentes pueden tener clientlibs adicionales específicas diseñadas para su uso en situaciones particulares, como cuando se emplean junto con Dynamic Media, por ejemplo.

Inclusión de bibliotecas de cliente including

Existen varias formas de incluir bibliotecas de cliente según el caso de uso. Los siguientes son ejemplos con Fragmentos de HTL de muestra para cada uno.

Uso predeterminado recomendado recommended-default-usage

Si no tiene tiempo para investigar la solución ideal para su caso, incluya las bibliotecas de cliente colocando las siguientes líneas HTL dentro del elemento head de su página:

<sly data-sly-use.clientlibs="${'com.adobe.cq.wcm.core.components.models.ClientLibraries' @
    categories='wknd.base', defer=true}">
    ${clientlibs.jsAndCssIncludes @ context="unsafe"}
</sly>

Esto incluirá tanto el CSS como el JS en la página head, pero si agrega el atributo defer a las inclusiones JS script, los exploradores esperarán a que el DOM esté listo antes de ejecutar los scripts y, por lo tanto, optimizarán la velocidad de carga de la página.

Uso básico basic-usage

La sintaxis básica para incluir JS y CSS de una categoría de biblioteca de cliente, que generará todos los elementos CSS link o elementos JS script correspondientes, es la siguiente:

<sly data-sly-use.clientlibs="${'com.adobe.cq.wcm.core.components.models.ClientLibraries' @ categories='wknd.base'}">
    ${clientlibs.jsAndCssIncludes @ context="unsafe"}
</sly>

Para hacer lo mismo para varias categorías de biblioteca de cliente a la vez, se puede pasar una matriz de cadenas al parámetro categories:

<sly data-sly-use.clientlibs="${'com.adobe.cq.wcm.core.components.models.ClientLibraries' @
    categories=['wknd.base', 'cq.foundation']}">
    ${clientlibs.jsAndCssIncludes @ context="unsafe"}
</sly>

Solo CSS o JS css-js-only

Con frecuencia, se desea colocar las inclusiones CSS en el elemento HTML head y el JS incluye justo antes del cierre del elemento body.

En head, para incluir solo el CSS y no el JS, utilice cssIncludes:

<sly data-sly-use.clientlibs="${'com.adobe.cq.wcm.core.components.models.ClientLibraries' @ categories='wknd.base'}">
    ${clientlibs.cssIncludes @ context="unsafe"}
</sly>

Antes de cerrar body, para incluir solo el JS y no el CSS, utilice jsIncludes:

<sly data-sly-use.clientlibs="${'com.adobe.cq.wcm.core.components.models.ClientLibraries' @ categories='wknd.base'}">
    ${clientlibs.jsIncludes @ context="unsafe"}
</sly>

Atributos attributes

Para aplicar atributos a los elementos link CSS generados o a los elementos JS script, es posible realizar una serie de parámetros:

<sly data-sly-use.clientlibs="${'com.adobe.cq.wcm.core.components.models.ClientLibraries' @
    categories='wknd.base',
    media='print',
    async=true,
    defer=true,
    onload='console.log(\'loaded: \' + this.src)',
    crossorigin='anonymous'}">
    ${clientlibs.jsAndCssIncludes @ context="unsafe"}
</sly>

Atributos CSS link que se pueden pasar a jsAndCssIncludes y cssIncludes:

  • media: atributos de JS de cadena script que se pueden pasar a jsAndCssIncludes y jsIncludes:
  • async: booleano
  • defer: booleano
  • onload: cadena
  • crossorigin: cadena

Integración inlining

En algunos casos, ya sea para la optimización o para correo electrónico o AMP, puede ser necesario integrar el CSS o JS en la salida del HTML.

Para integrar el CSS, se puede utilizar cssInline, en cuyo caso debe escribir el elemento style que lo rodea:

<style type="text/css"
    data-sly-use.clientlibs="${'com.adobe.cq.wcm.core.components.models.ClientLibraries' @ categories='wknd.base'}">
    ${clientlibs.cssInline @ context="unsafe"}
</style>

Del mismo modo, para insertar el JS, se puede utilizar jsInline, en cuyo caso debe escribir el elemento script que lo rodea:

<script type="text/javascript"
    data-sly-use.clientlibs="${'com.adobe.cq.wcm.core.components.models.ClientLibraries' @ categories='wknd.base'}">
    ${clientlibs.jsInline @ context="unsafe"}
</script>

Carga de JavaScript y CSS según el contexto context-aware-loading

El componente Página también admite la carga de etiquetas CSS, JavaScript o meta definidas por el desarrollador y según el contexto.

Esto se hace creando un recurso según el contexto para com.adobe.cq.wcm.core.components.config.HtmlPageItemsConfig con la siguiente estructura:

com.adobe.cq.wcm.core.components.config.HtmlPageItemsConfig
    - prefixPath="/some/path"
    + item01
        - element=["link"|"script"|"meta"]
        - location=["header"|"footer"]
        + attributes
            - attributeName01="attributeValue01"
            - attributeName02="attributeValue02"
            ...
    + item02
        ...
    ...

Consulte la documentación técnica del componente Página para obtener más información.

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c