Clientlibs para componentes de Communities

Introducción

En esta sección de la documentación se describe cómo agregar bibliotecas del lado del cliente (clientlibs) a una página para componentes de Communities.

Para obtener información básica, visite :

  • Uso de bibliotecas del lado del cliente, que proporcionan detalles de uso, así como herramientas de depuración
  • Clientlibs para SCF, que proporciona información útil al personalizar componentes de SCF

Por qué se requieren Clientlibs

Las bibliotecas de clientes son necesarias 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 clientlibs necesarios, estarán presentes en el sitio de la comunidad. Solo si los componentes adicionales van a estar disponibles para los autores, se necesitarán añadir clientlibs adicionales.

Cuando faltan los clientlibs requeridos, añadir un componente Communities a una página podría provocar errores de javascript y un aspecto inesperado.

Ejemplo : Revistas colocadas sin Clientlibs

colocado-review

Ejemplo : Revisiones colocadas con Clientlibs

review-clientlibs

Identificación de Clientlibs Requeridos

La información de funciones esenciales para los desarrolladores identifica los clientlibs necesarios.

Además, desde una instancia de AEM, al navegar por la Community Components Guide se proporciona acceso a una lista de categorías clientlib necesarias para un componente.

Por ejemplo, en la parte superior de la página Revisiones, los clientlibs requeridos que aparecen listados son

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

clientlibs-review

Adición de Clientlibs Necesarios

Cuando se desee añadir un componente Comunidades a una página, será necesario agregar las clientlibs necesarias para el componente si no está presente.

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

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

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

  • Busque el nodo clientlibslist para la página en la que desea añadir el componente:

    • /content/sites/sample/en/page/jcr:content/clientlibslist
  • Con el nodo clientlibslist seleccionado:

    • Busque la propiedad String[] scg:requiredClientLibs.

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

      • Desplácese hacia abajo si es necesario.

      • Seleccione + para introducir una nueva biblioteca de cliente.

        • Repita el proceso para agregar más bibliotecas de cliente.

        • Seleccione OK.

    • Seleccione Guardar todo.

NOTA

Si el sitio no es un sitio de la comunidad, es necesario descubrir la existencia o ubicación de las bibliotecas de cliente que se utilizan para el sitio.

Utilizando el ejemplo Introducción a AEM Communities, donde site-name es comprometer, así es como aparecería la lista clientliblist si agregara el componente de revisiones:

review-component

En esta página