Show Menu
トピック×

クライアント側のカスタマイズ

クライアント側の AEM Communities コンポーネントの外観や動作をカスタマイズするには、複数のアプローチがあります。
2 つの主要なアプローチは、コンポーネントのオーバーレイまたは拡張です。
コンポーネントの オーバーレイ によって、デフォルトのコンポーネントは変更され、コンポーネントのすべての参照が影響を受けます。
コンポーネントの 拡張 (一意の名前が付けられる)では、変更の範囲は制限されます。「extend」という用語は、「override」と同じ意味で使用されます。

オーバーレイ

コンポーネントのオーバーレイは、デフォルトのコンポーネントに変更を加え、デフォルトを使用するすべてのインスタンスに影響を与える方法です。
The overlay is accomplished by modifying a copy of the default component in the / apps directory, rather than modifying the original component in the / libs directory. コンポーネントは、「libs」が「apps」に置き換えられる以外、同じ相対パスを使用して構築されます。
リクエストを解決するために検索されるのは/appsディレクトリが最初で、見つからない場合は/libsディレクトリにあるデフォルトのバージョンが使用されます。
/libs ディレクトリ内のデフォルトコンポーネントは変更しないでください。/libs ディレクトリは、今後のパッチおよびアップグレードによって、公開インターフェイスのメンテナンス中に必要な方法で自由に変更されます。
This is different from extending a default component where the desire is to make modifications for a specific use, creating an unique path to the component and relying on referencing the original default component in the /libs directory as the super resource type.
For a quick example of overlaying the comments component, try the Overlay Comments Component tutorial .

拡張

コンポーネントの拡張(優先)は、デフォルトを使用するすべてのインスタンスに影響を及ぼさずに、特定の用途のために変更をおこなう方法です。拡張されたコンポーネントは、/apps フォルダー内で一意の名前が付けられ、/libs フォルダー内のデフォルトのコンポーネントを参照します。したがって、コンポーネントのデフォルトのデザインおよび動作は変更されません。
これは、Sling の性質によって libs/ フォルダー内を検索する前に apps/ フォルダーの相対参照を解決し、したがってコンポーネントのデザインまたは動作がグローバルに変更される、デフォルトのコンポーネントの オーバーレイ とは異なります。
コメントコンポーネントの拡張の簡単な例については、 コメントコンポーネントの拡張チュートリアル を試してください。

JavaScript バインド

コンポーネントの HBS スクリプトは、この機能を実装する JavaScript オブジェクト、モデルおよびビューにバインドされる必要があります。
The value of the data-scf-component attribute may be the default, such as social/tally/components/hbs/rating , or an extended (customized) component for customized functionality, such as weretail/components/hbs/rating .
コンポーネントをバインドするには、以下の属性を使用してコンポーネントスクリプト全体を <div> 要素で囲む必要があります。
  • data-component-id ="{}"
    コンテキストのidプロパティに解決されます。
  • data-scf-component =" <resourceType>
例えば、次のように入力しま /apps/weretail/components/hbs/rating/rating.hbs す。
<div class="we-Rating" data-component-id="{{id}}" data-scf-component="weretail/components/hbs/rating">

     <!-- HTML with HBS accessing the rating component -->

</div>

カスタムプロパティ

コンポーネントを拡張またはオーバーレイする場合、変更されたダイアログにプロパティを追加できます。
コンポーネント/リソースに対して設定されるすべてのプロパティには、handlebars テンプレートでプロパティキーを参照することによってアクセスできます。
{{properties.<property_name>}}

CSS のスキンの適用

Web サイトの全体的なテーマに合うようにコンポーネントをカスタマイズすることは、「スキンの適用」によって実現できます。これは、色、フォント、画像、ボタン、リンク、間隔および位置設定を特定の程度まで変更することです。
スキンの適用は、フレームワークスタイルを選択的に上書きすることによって、または完全に新しいスタイルシートを記述することによって実行できます。SCF コンポーネントによって、コンポーネントを構成するさまざまな要素に影響する、名前空間が設定された、モジュール式のセマンティック CSS クラスが定義されます。
コンポーネントにスキンを適用するには、次の手順に従います。
  1. 変更する要素(コンポーザー領域、ツールバーボタン、メッセージフォントなど)を指定します。
  2. これらの要素に影響する CSS クラス/ルールを識別します。
  3. スタイルシートファイル(.css)を作成します。
  4. Include the stylesheet in a client library folder ( clientlibs ) for your site and make sure it is included from your templates and pages with ui:includeClientLib .
  5. スタイルシートで指定したCSSクラスとルール(#2)を再定義し、スタイルを追加します。
これで、カスタムスタイルによってデフォルトのフレームワークスタイルは上書きされ、コンポーネントは新しいスキンでレンダリングされます。
Any CSS class name that is prefixed with scf-js has a specific use in javascript code. これらのクラスは、コンポーネントの状態(例えば、非表示から表示に切り替える)に影響し、上書きも削除も不要です。
While the scf-js classes do not affect styles, the class names may be used in stylesheets with the caveat that, as they control the states of elements, there may be side effects.

JavaScript の拡張

コンポーネントの JavaScript 実装を拡張するには、以下のことのみが必要です。
  1. jcr:resourceSuperTypeを拡張コンポーネントのjcr:resourceTypeの値(例:social/forum/components/hbs/forum)に設定して、アプリ用のコンポーネントを作成します。
  2. デフォルトのSCFコンポーネントのJavaScriptを調べて、SCF.registerComponent()を使用して登録する必要があるメソッドを判断します。
  3. 拡張コンポーネントのJavaScriptをコピーするか、または最初から開始します
  4. メソッドの拡張
  5. SCF.registerComponent()を使用して、すべてのメソッドをデフォルトまたはカスタマイズされたオブジェクトとビューのいずれかに登録します。

forum.js:フォーラム - HBS のサンプル拡張

(function($CQ, _, Backbone, SCF) {
    "use strict";
    var GMForumView = SCF.ForumView.extend({
        viewName: "GMForum",
        showComposer: function(e) {
            SCF.ForumView.prototype.toggleComposer.apply(this);
            var cancel = this.$el.find('.cancel-new-topic');
            cancel.toggle();
        },
        hideComposer: function(e) {
            SCF.ForumView.prototype.toggleComposer.apply(this);
            var cancel = this.$el.find('.cancel-new-topic');
            cancel.toggle();
        }
    });

    SCF.registerComponent('social/forum/components/hbs/post', SCF.Post, SCF.PostView);
    SCF.registerComponent('social/forum/components/hbs/topic', SCF.Topic, SCF.TopicView);
    SCF.registerComponent('social/forum/components/hbs/forum', SCF.Forum, GMForumView );
})($CQ, _, Backbone, SCF);

スクリプトタグ

スクリプトタグは、クライアント側のフレームワークに固有の要素です。 これらは、サーバー側で生成されたマークアップをクライアント側のモデルおよびビューにバインドするために役立ちます。
コンポーネントをオーバーレイまたは優先するときに SCF スクリプト内のスクリプトタグを削除しないでください。SCF script tags auto created for injecting JSON in the HTML are identified with the attribute data-scf-json=true .

SCF の clientlib

クライアント側ライブラリ (clientlib)の使用により、クライアント側でコンテンツをレンダリングするために使用される JavaScript および CSS を整理および最適化できます。
SCF の clientlib は、カテゴリ名内の「author」の存在のみが異なる 2 つのバリアントの具体的な命名パターンに従います。
clientlib のバリアント
カテゴリプロパティのパターン
完全 clientlib
cq.social.hbs.<component name>
オーサー clientlib
cq.social.author.hbs<component name>

完全 clientlib

完全(オーサー以外)clientlib には依存関係が含まれており、ui:includeClientLib を使用して含める場合に便利です。
これらのバージョンは、次の場所にあります。
  • /etc/clientlibs/social/hbs/&lt;component name&gt;
次に例を示します。
  • クライアントフォルダーノード: /etc/clientlibs/social/hbs/forum
  • Categoriesプロパティ: cq.social.hbs.forum
コミュニティコンポーネントガイド によって、各 SCF コンポーネントに必要なすべての clientlib が一覧表示されます。
コミュニティコンポーネントの clientlib では、clientlib をページに追加する方法が説明されています。

オーサー clientlib

オーサーバージョンの clientlib は、コンポーネントを実装するために必要な最小限の JavaScript に縮小されています。
これらの clientlib を直接含めることはできませんが、代わりに、サイト用に手動で作成された他の clientlib に埋め込むことができます。
これらのバージョンは、SCF libs フォルダー内にあります。
  • /libs/social/&lt;feature&gt;/components/hbs/&lt;component name&gt;/clientlibs
次に例を示します。
  • クライアントフォルダーノード: /libs/social/forum/hbs/forum/clientlibs
  • Categoriesプロパティ: cq.social.author.hbs.forum
注意:オーサー clientlib によって他のライブラリは埋め込まれませんが、依存関係は示されます。他のライブラリに埋め込む場合、依存関係は自動的に取り込まれず、埋め込む必要があります。
必要なオーサー clientlib は、 コミュニティコンポーネントガイド で各 SCF コンポーネントについてリストされた clientlib に「author」を挿入することによって識別できます。

使用上の考慮事項

サイトによってクライアントライブラリの管理方法は異なります。次のような要因が考えられます。
  • 全体的な速度:応答の速いサイトが目的ですが、最初のページのロードが少し遅いことは受け入れられる場合があります。多くのページが同じJavascriptを使用している場合、様々なJavascriptを1つのclientlibに埋め込み、最初のページから参照して読み込むことができます。 この単一のダウンロードでのJavaScriptはキャッシュされたままとなり、後続のページでダウンロードするデータ量を最小限に抑えます。
  • 迅速な最初のページ:最初のページが迅速にロードされることが目的である場合があります。この場合、JavaScriptは複数の小さなファイルに含まれ、必要な場所でのみ参照されます。
  • 最初のページのロードと後続のダウンロードとの間のバランス。