Clientlibs para componentes do Communities

Introdução

Esta seção da documentação descreve como adicionar bibliotecas do lado do cliente (clientlibs) a uma página para componentes do Communities.

Para obter informações básicas, visite :

  • Uso de bibliotecas do lado do cliente, que fornecem detalhes de uso e ferramentas de depuração
  • Clientlibs para SCF, que fornece informações úteis ao personalizar componentes do SCF

Por que clientlibs é necessário

Clientlibs são necessários para o funcionamento correto (JavaScript) e o estilo (CSS) de um componente.

Quando existe uma função da comunidade para um recurso, todos os componentes e configurações necessários, incluindo as clientlibs necessárias, estarão presentes no site da comunidade. Somente se componentes adicionais estiverem disponíveis para autores, será necessário adicionar clientlibs adicionais.

Quando as clientlibs necessárias estão ausentes, adicionar um componente Comunidades a uma página pode resultar em erros de javascript, bem como em uma aparência inesperada.

Exemplo : Revisões colocadas sem Clientlibs

revisões feitas

Exemplo : Revisões colocadas com Clientlibs

resenhas-clientlibs

Identificação de Clientlibs Obrigatórios

As informações de recursos essenciais para desenvolvedores identificam as clientlibs necessárias.

Além disso, de uma instância de AEM, navegar até o Guia de Componentes da Comunidade fornece acesso a uma lista de categorias clientlib necessárias para um componente.

Por exemplo, na parte superior da página Revisões, as clientlibs necessárias listadas são

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

clientlibs-resenhas

Adicionar Clientlibs Obrigatórios

Quando for desejado adicionar um componente Comunidades a uma página, será necessário adicionar as clientlibs necessárias para o componente, se ainda não estiverem presentes.

Use CRXDE|Lite para modificar uma lista de clientes existente para uma página de site da comunidade.

Para adicionar uma clientlib para um site da comunidade usando CRXDE Lite:

  • Navegue até https://<server>:<port>/crx/de.

  • Localize o nó clientlibslist da página na qual deseja adicionar o componente:

    • /content/sites/sample/en/page/jcr:content/clientlibslist
  • Com o nó clientlibslist selecionado:

    • Localize a propriedade String[] scg:requiredClientLibs.

    • Selecione seu Value para acessar a caixa de diálogo String array .

      • Role para baixo se necessário.

      • Selecione + para inserir uma nova biblioteca do cliente.

        • Repita para adicionar mais bibliotecas de clientes.

        • Selecione OK.

    • Selecione Salvar tudo.

OBSERVAÇÃO

Se o site não for um site da comunidade, a existência ou o local das bibliotecas de clientes em uso para o site precisará ser descoberto.

Usando o exemplo Introdução ao AEM Communities, onde site-name é engagement, esta é a forma como a clientliblist apareceria se o componente de revisões fosse adicionado:

componente de revisão

Nesta página