Bibliothèques clientes pour les composants de 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 de Communities.
Pour obtenir des informations de base, voir :
- Utilisation des 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 pour la personnalisation des composants SCF
Pourquoi les bibliothèques clientes sont-elles requises ? why-clientlibs-are-required
Les bibliothèques clientes sont requises pour le bon fonctionnement (JavaScript) et le style (CSS) d’un composant.
Lorsqu’il existe une fonction de communauté pour une fonctionnalité, tous les composants et configurations nécessaires, y compris les bibliothèques clientes requises, sont présents dans le site de la communauté. D’autres bibliothèques clientes doivent être ajoutées uniquement si des composants supplémentaires doivent être disponibles pour les auteurs.
Lorsque les bibliothèques clientes requises sont manquantes, l’ajout d’un composant Communities à une page peut entraîner des erreurs JavaScript et une apparence inattendue.
Exemple : révisions effectuées sans Clientlibs example-placed-reviews-without-clientlibs
Exemple : commentaires placés avec Clientlibs example-placed-reviews-with-clientlibs
Identification des bibliothèques clientes requises identifying-required-clientlibs
Les informations essentielles sur les fonctionnalités destinées aux développeurs identifient les bibliothèques clientes requises.
En outre, à partir d’une instance AEM, en accédant au guide des composants de la communauté vous pouvez accéder à une liste des catégories de bibliothèques clientes requises pour un composant.
Par exemple, en haut de la page Examens les bibliothèques clientes requises répertoriées sont les suivantes :
- cq.ckeditor
- cq.social.hbs.views
Ajout des bibliothèques clientes requises adding-required-clientlibs
Lorsque vous souhaitez ajouter un composant Communities à une page, il est nécessaire d’ajouter les bibliothèques clientes requises pour le composant, si elles ne sont pas déjà présentes.
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 🔗 :
-
Accédez à https://<server>:<port>/crx/de.
-
Recherchez le nœud
clientlibslistde la page sur laquelle vous souhaitez ajouter le composant :/content/sites/sample/en/page/jcr:content/clientlibslist
-
Avec
clientlibslistnœud sélectionné :-
Recherchez le
scg:requiredClientLibsde propriété String[] . -
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 saisir 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 à quoi la liste de bibliothèques clientes s’afficherait si vous ajoutiez le composant révisions :
