Clientlibs für Communities-Komponenten

Einführung

In diesem Abschnitt der Dokumentation wird beschrieben, wie Sie clientseitige Bibliotheken (clientlibs) zu einer Seite für Communities-Komponenten hinzufügen.

Grundlegende Informationen finden Sie unter:

• Verwendung clientseitiger Bibliotheken, die Nutzungsdetails sowie Debugging-Tools bereitstellt
• Clientlibs für SCF, die nützliche Informationen beim Anpassen von SCF-Komponenten bereitstellen
• Blog: AEM Client-Bibliotheken, erklärt durch Beispiel

Warum Clientlibs erforderlich sind

Clientlibs sind für die ordnungsgemäße Funktion (JavaScript) und Formatierung (CSS) einer Komponente erforderlich.

Wenn für eine Funktion eine Community-Funktion vorhanden ist, sind alle erforderlichen Komponenten und Konfigurationen, einschließlich der erforderlichen clientlibs, auf der Community-Site vorhanden. Nur wenn Autoren zusätzliche Komponenten zur Verfügung stehen sollen, müssen zusätzliche Client-Bibliotheken hinzugefügt werden.

Wenn die erforderlichen clientlibs fehlen, kann das Hinzufügen einer Communities-Komponente zu einer Seite🔗 zu JavaScript-Fehlern sowie zu einem unerwarteten Erscheinungsbild führen.

Beispiel: Platzierte Prüfungen ohne Clientlibs

Beispiel: Placed Reviews with clientlibs

Identifizieren erforderlicher Clientlibs

Die grundlegenden Funktionsinformationen für Entwickler identifizieren die erforderlichen Clientlibs.

Darüber hinaus bietet das Navigieren von einer AEM-Instanz zum Community Components Guide Zugriff auf eine Liste von clientlib-Kategorien, die für eine Komponente erforderlich sind.

Am Anfang der Seite "Bewertungen" sind die erforderlichen clientlibs aufgeführt.

• cq.ckeditor
• cq.social.hbs.reviews

Hinzufügen erforderlicher Clientlibs

Wenn Sie eine Communities-Komponente zu einer Seite hinzufügen möchten, müssen Sie die erforderlichen Clientlibs für die Komponente hinzufügen, falls diese noch nicht vorhanden ist.

Verwenden Sie CRXDE|Lite, um eine vorhandene Clientlibslist für eine Community-Site-Seite zu ändern.

So fügen Sie eine clientlib für eine Community-Site mit CRXDE Lite hinzu:

• Navigieren Sie zu https://<server>:<port>/crx/de

• Suchen Sie den Knoten clientlibslist für die Seite, auf der Sie die Komponente hinzufügen möchten

  • /content/sites/sample/en/page/jcr:content/clientlibslist

• Mit dem ausgewählten Knoten clientlibslist

  • Suchen Sie die Eigenschaft String[] scg:requiredClientLibs .

  • Wählen Sie die zugehörige Value aus, um auf das Dialogfeld "String-Array"zuzugreifen

    • Scrollen Sie bei Bedarf nach unten

    • Wählen Sie + aus, um eine neue Client-Bibliothek einzugeben.

      • Wiederholen Sie diesen Vorgang, um weitere Client-Bibliotheken hinzuzufügen.

    • Wählen Sie OK aus

  • Wählen Sie Alle speichern

Unter Verwendung des Beispiels Erste Schritte mit AEM Communities, in dem site-name engage ist, würde die clientliblist so angezeigt, wenn die Überprüfungskomponente hinzugefügt wird: