コミュニティコンポーネントの clientlib

はじめに

ドキュメントのこの節では、コミュニティコンポーネント用のクライアント側ライブラリ(clientlib)をページに追加する方法について説明します。

基本情報については、以下を参照してください。

clientlib が必要になる理由

コンポーネントを正しく機能させ(JavaScript)、スタイル設定する(CSS)には、clientlib が必要です。

が存在する場合、 コミュニティ機能 機能の場合、必要な clientlib を含む必要なすべてのコンポーネントと設定がコミュニティサイトに表示されます。 作成者が追加のコンポーネントを使用できる場合にのみ、追加の clientlib を追加する必要があります。

必須の clientlib が欠落していると、ページにコミュニティコンポーネントを追加したときに、JavaScript エラーが発生したり、予期しない外観が生じたりする可能性があります。

例:clientlib が欠落している場合のレビューの配置

chlimage_1-244

例:clientlib が存在する場合のレビューの配置

chlimage_1-245

必須の clientlib の識別

開発者向けの基本機能情報の中で、必須の clientlib が識別されています。

また、AEM インスタンスからコミュニティコンポーネントガイドを参照すると、コンポーネントに必須の clientlib カテゴリのリストにアクセスできます。

例えば、 レビューページ 以下に、必要な clientlib を示します。

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

chlimage_1-246

必須の clientlib の追加

コミュニティコンポーネントをページに追加する場合、コンポーネントに必須の clientlib がまだ存在しなければ、追加する必要があります。

CRXDE|Lite を使用すると、コミュニティサイトページの既存の clientlibslist を変更できます。

を使用してコミュニティサイトに clientlib を追加するには CRXDE Lite:

  • 参照先 https://<server>:<port>/crx/de

  • clientlibslist コンポーネントを追加するページのノード

    • /content/sites/sample/en/page/jcr:content/clientlibslist
  • を使用 clientlibslist 選択されたノード

    • 文字列[] プロパティ scg:requiredClientLibs

    • 選択 Value 「文字列配列」ダイアログにアクセスするには

      • 必要に応じて下にスクロールします。

      • 選択 + 新しいクライアントライブラリに入るには

        • 繰り返してクライアントライブラリをさらに追加します
      • OK」を選択します。

    • すべて保存」を選択します。

メモ

コミュニティサイト以外のサイトでは、使用されているクライアントライブラリの有無や場所を調べる必要があります。

ここでは、AEM Communities 使用の手引きの例(site-nameengage)を引用し、レビューコンポーネントを追加する場合に clientliblist がどのように表示されるかを示しています。

chlimage_1-247

このページ