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 :

• Usar 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 SCF
• Blog : Bibliotecas AEM clientes explicadas por exemplo

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

Exemplo: Revisões colocadas com 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

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.

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: