Show Menu
SUJETS×

Clientlibs pour les composants Communities

Présentation

Cette section de la documentation décrit comment ajouter des bibliothèques côté client (clientlibs) à une page pour les composants Communities.
Pour obtenir des informations de base, consultez :

Raisons pour lesquelles les bibliothèques clientes sont requises

Les bibliothèques clientes sont requises pour le bon fonctionnement (JavaScript) et le style (CSS) d’un composant.
Lorsqu’il existe une fonction de communauté pour une fonction, tous les composants et configurations nécessaires, y compris les clients requis, seront présents sur le site de la communauté. Ce n'est que si des composants supplémentaires doivent être disponibles pour les auteurs que des clients supplémentaires doivent être ajoutés.
Lorsque les clientlibs requis sont manquants, l’ ajout d’un composant Communities à une page peut entraîner des erreurs JavaScript et un aspect inattendu.

Exemple : Révisions importées sans bibliothèques clientes

Exemple : Révisions importées avec des bibliothèques clientes

Identification des bibliothèques clientes requises

Les informations essentielles pour les développeurs identifient les clients requis.
En outre, à partir d’une instance AEM, l’accès au Guide des composants de la communauté permet d’accéder à une liste des catégories clientlib requises pour un composant.
Par exemple, en haut de la page reviews.html Révisions, les clients requis répertoriés sont
  • cq.ckeditor
  • cq.social.hbs.reviews

Ajout de bibliothèques clientes requises

Lorsqu’il est nécessaire d’ajouter un composant Communautés à une page, il est nécessaire d’ajouter les clients requis pour le composant s’il n’est pas déjà présent.
Utilisez CRXDE|Lite pour modifier une liste de clients existante pour une page de site communautaire.
Pour ajouter une bibliothèque cliente pour un site communautaire à l’aide de CRXDE Lite :
  • Localisez le clientlibslist noeud de la page sur laquelle vous souhaitez ajouter le composant.
    • /content/sites/sample/en/page/jcr:content/clientlibslist
  • Avec le clientlibslist noeud sélectionné
    • Localisation de la propriété String #scg:requiredClientLibs
    • Sélectionnez son Value accès à la boîte de dialogue Tableau de chaînes
      • Faire défiler vers le bas si nécessaire
      • Sélectionner + pour entrer une nouvelle bibliothèque cliente
        • Répéter pour ajouter d’autres bibliothèques clientes
      • Cliquez sur OK
    • Select Save All
Si le site n'est pas un site communautaire, l'existence ou l'emplacement des bibliothèques clientes utilisées pour le site devront être découverts.
A l’aide de l’exemple Prise en main des communautés AEM, où site-name s’engage **, voici comment la liste cliente s’affichera si vous ajoutez le composant de révisions :