Clientlibs para componentes das comunidades clientlibs-for-communities-components

Introdução introduction

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

Para obter informações básicas, consulte o seguinte:

Por que as bibliotecas de clientes são necessárias why-clientlibs-are-required

As bibliotecas de clientes são necessárias para o funcionamento adequado (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, estão presentes no site da comunidade. Somente se os componentes adicionais estiverem disponíveis para os autores, é necessário adicionar mais clientlibs.

Quando as clientlibs necessárias estiverem ausentes, adição de um componente Comunidades a uma página poderia resultar em erros de JavaScript e uma aparência inesperada.

Exemplo: análises colocadas sem clientlibs example-placed-reviews-without-clientlibs

places-review

Exemplo: Análises Feitas com Clientlibs example-placed-reviews-with-clientlibs

review-clientlibs

Identificação das clientlibs necessárias identifying-required-clientlibs

As informações essenciais do recurso para desenvolvedores identificam as clientlibs necessárias.

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

Por exemplo, na parte superior da Página de análises as clientlibs necessárias listadas são

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

clientlibs-review

Adicionar Clientlibs Necessárias adding-required-clientlibs

Quando quiser adicionar um componente Comunidades a uma página, será necessário adicionar as clientlibs necessárias para o componente, se ainda não estiver presente.

Uso CRXDE|Lite para modificar uma clientlibslist existente para uma página de site da comunidade.

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

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

  • Localize o clientlibslist para a página em que deseja adicionar o componente:

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

    • Localize a string[] propriedade scg:requiredClientLibs.

    • Selecionar sua Value para poder acessar a caixa de diálogo Matriz de string.

      • Role para baixo, se necessário.

      • Selecione + para inserir uma nova biblioteca do cliente.

        • Repita para adicionar mais bibliotecas de clientes.

        • Selecionar OK.

    • Selecionar Salvar tudo.

NOTE
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 devem ser descobertos.

Usar o Introdução ao AEM Communities exemplo, onde site-name é engajar, é assim que a clientliblist apareceria se adicionasse o componente de revisões:

componente de revisão

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791