clipplibs für Communities-Komponenten

Einführung

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

Grundlegende Informationen finden Sie unter:

• Verwenden clientseitiger Bibliotheken, die Nutzungsdetails sowie Debuggingwerkzeuge bereitstellen
• clipplibs für SCF, das nützliche Informationen zum Anpassen von SCF-Komponenten bereitstellt
• Blog: AEM Client-Bibliotheken, erklärt durch Beispiel

Warum clientlibs erforderlich ist

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

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

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

Beispiel: Platzierte Reviews ohne clientlibs

Beispiel: Platzierte Reviews mit clientlibs

Identifizieren erforderlicher Clientlibs

Die wesentlichen Funktionsinformationen für Entwickler identifizieren die erforderlichen clientlibs.

Darüber hinaus können Sie von einer AEM Instanz aus im Community-Komponentenleitfaden auf eine Auflistung der für eine Komponente erforderlichen clientlib-Kategorien zugreifen.

Beispiel: Am oberen Rand der Seite Reviews sind die erforderlichen clientlibs aufgelistet

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

Erforderliche Clientlibshinzufügen

Wenn Sie einer Seite eine Communities-Komponente 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 mithilfe von CRXDE Lite eine clientlib für eine Community-Site hinzu:

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

• Bei Auswahl des Knotens clientlibslist

  • Suchen Sie die Eigenschaft String[] scg:requiredClientLibs

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

    • Bei Bedarf scrollen

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

      • Wiederholen, um weitere Client-Bibliotheken hinzuzufügen

    • Wählen Sie OK aus

  • Wählen Sie Alle speichern

Mithilfe des Beispiels Erste Schritte mit AEM Communities, bei dem site-name engagement lautet, wird die clientliblist wie folgt angezeigt, wenn die Komponente "reviews"hinzugefügt wird: