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, visitez :

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

examens placés

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

reviews-clientlibs

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

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

  • Recherchez 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 du 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 cette 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, il faudrait découvrir l'existence ou l'emplacement des bibliothèques clientes utilisées pour le site.

À 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 :

composant de révision

Sur cette page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now