Inclusión de bibliotecas de cliente
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
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
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 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 cadenascript
que se pueden pasar ajsAndCssIncludes
yjsIncludes
:async
: booleanodefer
: booleanoonload
: cadenacrossorigin
: cadena
Integració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 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
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
...
...