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 :

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 communautaire pour une fonctionnalité, tous les composants et configurations nécessaires, y compris les bibliothèques clientes requises, seront 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.

Lorsque les clientlibs requises sont manquantes, ajout d’un composant Communautés à 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, accédez au Guide des composants de communauté permet d’accéder à la liste des catégories clientlib requises pour un composant.

Par exemple, tout en haut de la page Page des révisions les clientlibs requises répertoriées sont

  • 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.

Utilisation CRXDE|Lite pour modifier une liste de bibliothèques clientes existante pour une page de site communautaire.

Pour ajouter une bibliothèque cliente à un site de la communauté à l’aide d’ CRXDE Lite:

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

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

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

    • Localisation de la chaîne[] property scg:requiredClientLibs

    • Sélectionnez 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électionner + 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.

En utilisant la variable Prise en main d’AEM Communities exemple, où site-name is engager, voici comment clientliblist s’affiche lors de l’ajout du composant de révisions :

chlimage_1-247

Sur cette page