Componentes de Clientlibs para Comunidades

Introducción

Esta sección de la documentación describe cómo agregar bibliotecas de cliente (clientlibs) a una página para componentes de Comunidades.

Para obtener información básica, visite:

• Uso de las bibliotecas del lado del cliente que proporcionan detalles de uso, así como herramientas de depuración
• Clientlibs para SCFque proporciona información útil al personalizar componentes SCF
• Blog: Bibliotecas de clientes de AEM explicadas por ejemplo

Por qué los clientes son necesarios

Los clientes son necesarios para el correcto funcionamiento (JavaScript) y el estilo (CSS) de un componente.

Cuando existe una función de comunidad para una función, todos los componentes y configuraciones necesarios, incluidos los clientes requeridos, estarán presentes en el sitio de la comunidad. Solo si los autores disponen de componentes adicionales, se necesitarían agregar clientes adicionales.

Cuando faltan los clientes requeridos, la adición de un componente Communities a una página podría provocar errores de javascript y un aspecto inesperado.

Ejemplo: Revistas colocadas sin Clientlibs

Ejemplo: Revistas colocadas con Clientlibs

Identificación de Clientlibs requeridos

La información esencial de las funciones para los desarrolladores identifica a los clientes requeridos.

Además, desde una instancia de AEM, la búsqueda en la Guía de componentes de comunidad proporciona acceso a una lista de categorías clientlib necesarias para un componente.

Por ejemplo: en la parte superior de la página de revisiones, los clientes requeridos que aparecen son

• cq.ckeditor
• cq.social.hbs.reviews

Añadir Clientlibs requeridos

Cuando se desee agregar un componente Comunidades a una página, será necesario agregar los clientes necesarios para el componente si no están presentes.

Utilice CRXDE|Lite para modificar una lista de clientes existente para una página de sitio de comunidad.

Para agregar una clientlib para un sitio de comunidad mediante CRXDE Lite:

• Vaya a https://<server>:<port>/crx/de

• Busque el nodo clientlibslist de la página en la que desea agregar el componente

  • /content/sites/sample/en/page/jcr:content/clientlibslist

• Con nodo clientlibslist seleccionado

  • Busque la propiedad String[] scg:requiredClientLibs

  • Seleccione su Value para acceder al cuadro de diálogo de la matriz de cadenas

    • Desplácese hacia abajo si es necesario

    • Seleccione + para introducir una nueva biblioteca de cliente

      • Repetir para agregar más bibliotecas de cliente

    • Seleccione Aceptar

  • Seleccione Guardar todo

Utilizando el ejemplo Introducción a AEM Communities, donde site-name es engagement, así es como aparecerá clientliblist si agrega el componente de revisiones: