Clientlibs des 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 :

  • Utilisation de bibliothèques côté client qui fournit des détails d’utilisation ainsi que des outils de débogage
  • Clientlibs pour SCF qui fournit des informations utiles lors de la personnalisation des composants SCF

Pourquoi les bibliothèques côté client sont nécessaires

Les bibliothèques côté client sont nécessaires au bon fonctionnement (JavaScript) et au 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 clientlibs requises, sont présents sur le site de la communauté. Il est nécessaire d’ajouter des clientlibs supplémentaires uniquement si des composants supplémentaires doivent être disponibles pour les auteurs.

Si les clientlibs requises sont manquantes, l’ajout d’un composant Communities à une page peut entraîner des erreurs JavaScript et un aspect inattendu.

Exemple : Révisions placées sans clientlibs

chlimage_1-244

Exemple : Révisions placées avec Clientlibs

chlimage_1-245

Identification des bibliothèques clientes requises

Les informations de fonction essentielles pour les développeurs identifient les clientlibs requises.

En outre, à partir d’une instance AEM, l’accès au Guide des composants de la communauté permet d’accéder à la liste des catégories clientlib requises pour un composant.

Par exemple, en haut de la page Révisions, les clientlibs requises sont répertoriées.

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

chlimage_1-246

Ajout de bibliothèques clientes requises

Si vous souhaitez ajouter un composant Communities à une page, vous devez ajouter les bibliothèques clientes requises pour le composant s’il n’est pas déjà présent.

Utilisez CRXDE|Lite pour modifier une liste de bibliothèques clientes existante pour une page de site de communauté.

Pour ajouter une bibliothèque cliente pour un site communautaire à l’aide de CRXDE Lite :

  • Accédez à https://<serveur>:<port>/crx/de

  • Recherchez le noeud clientlibslist de la page sur laquelle vous souhaitez ajouter le composant.

    • /content/sites/sample/en/page/jcr:content/clientlibslist
  • Avec le noeud clientlibslist sélectionné

    • Localisez la propriété String[] scg:requiredClientLibs

    • Sélectionnez sa Value pour accéder à la boîte de dialogue Tableau de chaînes .

      • Faites défiler la page vers le bas si nécessaire

      • Sélectionnez + pour entrer une nouvelle bibliothèque cliente.

        • Répétez l’opération pour ajouter d’autres bibliothèques clientes.
      • Cliquez sur OK

    • Sélectionnez Enregistrer tout.

REMARQUE

Si le site n’est pas un site communautaire, l’existence ou l’emplacement des bibliothèques clientes utilisées pour le site doivent être découverts.

À l’aide de l’exemple Prise en main d’AEM Communities, où site-name est engage, voici comment la liste client s’afficherait lors de l’ajout du composant de révisions :

chlimage_1-247

Sur cette page