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 :

• Utilisation des 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
• 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 référencé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 à un site communautaire à l'aide de CRXDE Lite:

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

• 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

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