Componentes do Clientlibs para Comunidades

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 :

Por que os clientlibs são obrigatórios

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

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

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

Exemplo: Revisões feitas sem Clientlibs

revisões feitas

Exemplo: Revisões colocadas com Clientlibs

review-clientlibs

Identificando Clientlibs Necessários

As informações de recursos essenciais para desenvolvedores identificam os clientlibs necessários.

Além disso, de uma instância AEM, navegar até Community Components Guide fornece acesso a uma lista de categorias clientlib necessárias para um componente.

Por exemplo, na parte superior da página de revisões os clientlibs necessários listados são

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

clientlibs-review

Adicionando Clientlibs Necessários

Quando for desejado adicionar um componente Comunidades a uma página, será necessário adicionar os clientlibs necessários para o componente, caso ainda não estejam presentes.

Use CRXDE|Lite para modificar uma clientlibslist existente para uma página do 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 Value para acessar a caixa de diálogo String array.

      • Role para baixo se necessário.

      • Selecione + para inserir uma nova biblioteca de cliente.

        • Repita o procedimento 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 clientes em uso para o site precisará ser descoberto.

Usando o exemplo Introdução ao AEM Communities, onde site-name é engajar, esta é a forma como a clientliblist aparecerá se o componente de revisão for adicionado:

componente de revisão

Nesta página