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:
- Usando Bibliotecas do Lado do Cliente que fornece detalhes de uso e ferramentas de depuração
- Clientlibs para SCF que fornece informações úteis ao personalizar componentes SCF
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 de 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, adicionar um componente de Comunidades a uma página poderá resultar em erros de JavaScript e em uma aparência inesperada.
Exemplo: análises colocadas sem clientlibs example-placed-reviews-without-clientlibs
Exemplo: Análises Feitas com Clientlibs example-placed-reviews-with-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, a partir de uma instância do AEM, navegar até o Guia de Componentes da Comunidade fornece acesso a uma lista de categorias de clientlib necessárias para um componente.
Por exemplo, na parte superior da página Análises, as bibliotecas de clientes necessárias listadas são
- cq.ckeditor
- cq.social.hbs.reviews
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.
Use o CRXDE|Lite para modificar uma clientlibslist existente para uma página de site da comunidade.
Para adicionar um clientlib para um site da comunidade usando o CRXDE Lite:
-
Navegue até https://<server>:<port>/crx/de.
-
Localize o nó
clientlibslist
da página em que você deseja adicionar o componente:/content/sites/sample/en/page/jcr:content/clientlibslist
-
Com o nó
clientlibslist
selecionado:-
Localize a propriedade
scg:requiredClientLibs
da Cadeia de Caracteres []. -
Selecione seu
Value
para poder acessar a caixa de diálogo Matriz de cadeia de caracteres.-
Role para baixo, se necessário.
-
Selecione + para inserir uma nova biblioteca do cliente.
-
Repita para adicionar mais bibliotecas de clientes.
-
Selecione OK.
-
-
-
Selecione Salvar tudo.
-
Usando o exemplo de Introdução ao AEM Communities, em que site-name
é engajamento, esta é a forma como a clientliblist aparecerá se o componente de revisões for adicionado: