Clientlibs para componentes das comunidades

Introdução

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

Para informações básicas, visite:

Por que as bibliotecas de clientes são necessárias

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, estarão presentes no site da comunidade. Somente se os componentes adicionais estiverem disponíveis para os autores, as bibliotecas de clientes adicionais precisarão ser adicionadas.

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

Exemplo: análises colocadas sem clientlibs

places-review

Exemplo: Análises Feitas com Clientlibs

review-clientlibs

Identificação das clientlibs necessárias

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 do Página de análises as clientlibs necessárias listadas são

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

clientlibs-review

Adicionar Clientlibs Necessárias

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 para 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 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.

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.

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

Nesta página