Clientlibs des composants Communities clientlibs-for-communities-components
Présentation introduction
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 why-clientlibs-are-required
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 example-placed-reviews-without-clientlibs
Exemple : Révisions placées avec Clientlibs example-placed-reviews-with-clientlibs
Identification des bibliothèques clientes requises identifying-required-clientlibs
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
Ajout de bibliothèques clientes requises adding-required-clientlibs
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.
-
Sélectionnez OK
-
-
Sélectionnez Enregistrer tout
-
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 :