Clientlibs para componentes de 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, adicionar 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 feitas com Clientlibs

Como identificar clientlibs obrigatórios

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

Além disso, de uma instância 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, os clientlibs necessários listados são

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

Adicionando Clientlibs Obrigató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 lista de clientlibslist existente para uma página do site da comunidade.

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

• Navegue até https://<servidor>:<porta>/crx/de.

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

  • /content/sites/sample/en/page/jcr:content/clientlibslist

• Com o clientlibslist nó selecionado:

  • Localize a propriedade String[] scg:requiredClientLibs.

  • Selecione sua opção 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 está envolvido, esta é a forma como a clientliblist aparecerá se você adicionar o componente de revisões: