Clientlibs des composants Communities

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

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

Exemple : révisions placées avec Clientlibs

Identification des bibliothèques clientes requises

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

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 :