Inclusión de bibliotecas de cliente

Existen varias formas de incluir bibliotecas de cliente según el caso de uso. Este documento proporciona ejemplos y muestra fragmentos de HTL para cada uno.

Si no tiene tiempo para investigar qué es lo mejor de su situación, incluya las bibliotecas de cliente colocando las siguientes líneas HTML 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 las secuencias de comandos y, por lo tanto, optimizarán la velocidad de carga de la página.

Uso básico

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

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

Para aplicar atributos a los elementos link CSS generados y/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: boolean
  • defer: booleano
  • onload: cadena
  • crossorigin: cadena

Inclinación

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 insertar 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>

Cargando CSS y JavaScript con contexto

El Componente de 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.

En esta página