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 des bibliothèques côté client qui fournit des détails d’utilisation et des outils de débogage
- Clientlibs for 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 à la mise en forme (CSS) d’un composant.
Lorsqu’il existe une fonction de communauté pour une fonction, tous les composants et configurations nécessaires, y compris les bibliothèques clientes requises, sont présents dans 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, l’ajout d’un composant Communities à 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, l’accès au Guide des composants de la communauté permet d’accéder à la liste des catégories clientlib requises pour un composant.
Par exemple, en haut de la page de 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.
Utilisez CRXDE|Lite pour modifier une liste de bibliothèques clientes 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://<server>:<port>/crx/de.
-
Recherchez le noeud
clientlibslistde la page sur laquelle vous souhaitez ajouter le composant :/content/sites/sample/en/page/jcr:content/clientlibslist
-
Avec le noeud
clientlibslistsélectionné :-
Localisez la propriété String[]
scg:requiredClientLibs. -
Sélectionnez son
Valuepour 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 reprenant l’exemple Prise en main d’AEM Communities, où site-name est engage, voici comment la clientliblist s’affiche en cas d’ajout du composant de révisions :
