Clientlibs pour les composants de communautés

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 for SCFqui fournit des informations utiles lors de la personnalisation des composants SCF
• Blog : aem bibliothèques clientes expliquées par l’exemple

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 communautaire pour une fonction, tous les composants et configurations nécessaires, y compris les clientlibs requis, seront présents sur le site communautaire. Ce n'est que si d'autres composants doivent être disponibles pour les auteurs que des clientlibs 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 ainsi qu'un aspect inattendu.

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

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

Identification des bibliothèques clientes requises

Les informations essentielles pour les développeurs identifient les clients requis.

De plus, à 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 Révisions, les clientlibs requis répertoriés sont

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

Ajouter les bibliothèques clientes requises

Si vous souhaitez ajouter un composant Communautés à une page, vous devez ajouter les clientlibs requis pour le composant si celui-ci 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 :

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

• Localisez le noeud clientlibslist pour 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 Value pour accéder à la boîte de dialogue de tableau de chaînes.

    • Faire défiler vers le bas si nécessaire

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

      • Répéter pour ajouter d’autres bibliothèques clientes

    • Cliquez sur OK

  • Sélectionner Enregistrer tout

À l'aide de l'exemple Prise en main d'AEM Communities, où site-name est engager, voici comment la liste cliente s'affichera si vous ajoutez le composant de révision :