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 plus d’informations, voir :
- Utilisation de bibliothèques côté client qui fournit des détails d’utilisation et 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, sont présents sur le site de la communauté. Les auteurs ne doivent ajouter des clientlibs supplémentaires que si d’autres composants doivent être disponibles.
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, 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, il est nécessaire d’ajouter les clientlibs 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 communautaire à l’aide de la fonction CRXDE Lite:
-
Accédez à https://<server>:<port>/crx/de.
-
Recherchez la variable
clientlibslist
pour 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
vous pouvez donc accéder à la boîte de dialogue Tableau de chaînes .-
Faites défiler l’écran vers le bas si nécessaire.
-
Sélectionnez + 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 révisions :