用戶端自訂 client-side-customization

若要自訂用戶端上AEM Communities元件的外觀和/或行為，有數種方法。

覆蓋或延伸元件是兩種主要方法。

覆蓋 元件會更改預設元件，並影響元件的每個參照。

延伸 元件（名稱唯一）會限制變更的範圍。 「extend」一詞與「override」可交互使用。

覆蓋 overlays

覆蓋元件是對預設元件進行修改並影響使用預設值的所有實例的方法。

覆蓋是透過修改/中預設元件的復本來完成​ app 目錄，而非修改/中的原始元件​ libs 目錄。 元件是以相同的相對路徑建構，除了「libs」會取代為「apps」。

首先搜尋/apps目錄以解決請求，若找不到，則使用/libs目錄中的預設版本。

不得修改/libs目錄中的預設元件，因為將來的修補程式和升級可以在維護公共介面時，以任何必要的方式更改/libs目錄。

這與 延伸 預設元件，其中需要為特定用途進行修改，建立元件的唯一路徑，並依賴在/libs目錄中引用原始預設元件作為超級資源類型。

有關覆蓋注釋元件的快速示例，請嘗試 覆蓋注釋元件教學課程.

擴充功能 extensions

擴充（覆寫）元件是修改特定用途而不影響使用預設值的所有執行個體的方法。 擴展元件在/apps資料夾中具有唯一名稱，並引用/libs資料夾中的預設元件，因此不會修改元件的預設設計和行為。

這與 覆蓋 預設元件，其中Sling的性質會在搜尋libs/資料夾之前解析應用程式/資料夾的相對參照，因此元件的設計或行為會全域修改。

有關擴展注釋元件的快速示例，請嘗試 擴充注釋元件教學課程.

Javascript系結 javascript-binding

元件的HBS指令碼必須系結至實作此功能的JavaScript物件、模型和檢視。

的值 data-scf-component 屬性可以是預設值，例如 social/tally/components/hbs/rating，或擴充（自訂）元件，以自訂功能，例如 weretail/components/hbs/rating.

若要系結元件，必須將整個元件指令碼圍在 <div> 元素（具有下列屬性）:

例如，從 /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>

自訂屬性 custom-properties

在擴展或覆蓋元件時，可以將屬性添加到修改的對話框。

可通過參考handlebars模板中的屬性鍵來訪問元件/資源上設定的所有屬性：

{{properties.<property_name>}}

設定CSS外觀 skinning-css

定制元件以匹配網站的整體主題可以通過「外觀」（在一定程度上更改顏色、字型、影像、按鈕、連結、間距甚至定位）來實現。

可通過選擇性地覆蓋框架樣式或通過撰寫全新樣式表來實現外觀設定。 SCF元件定義命名節點、模組化和語義CSS類，這些類影響構成元件的各種元素。

要外觀元件，請執行以下操作：

自訂樣式現在會覆寫預設的架構樣式，而元件將會以新外觀呈現。

擴充Javascript extending-javascript

若要擴充元件Javascript實施，您只需

forum.js:論壇擴充範例 — HBS forum-js-sample-extension-of-forum-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);

指令碼標籤 script-tags

指令碼標籤是用戶端架構的固有部分。 它們是膠水，有助於將伺服器端產生的標籤與用戶端的模型和檢視系結。

覆蓋或覆蓋元件時，不應移除SCF指令碼中的指令碼標籤。 自動為在HTML中插入JSON而建立的SCF指令碼標籤會以屬性識別 data-scf-json=true。

SCF的Clientlibs clientlibs-for-scf

使用 用戶端程式庫 (clientlibs)，提供組織和最佳化用於呈現用戶端內容的Javascript和CSS的方法。

SCF的clientlib會遵循兩種變體非常特定的命名模式，而這兩種模式只會因類別名稱中是否存在「author」而有所不同：

完成Clientlib complete-clientlibs

完整（非作者）clientlib包含相依性，且方便搭配ui:includeClientLib加入。

這些版本位於：

例如：

此 社群元件指南 列出每個SCF元件所需的完整客戶端庫。

Communities元件的Clientlibs 說明如何將clientlib新增至頁面。

作者Clientlibs author-clientlibs

製作版本clientlib會去除至實作元件所需的最小Javascript。

這些clientlib絕不應直接包含在內，而是可內嵌至其他clientlib，這些clientlib是為網站手工編製。

在SCF libs資料夾中找到以下版本：

例如：

注意：雖然作者clientlibs絕不內嵌其他程式庫，但會列出其相依性。 內嵌在其他程式庫時，不會自動提取相依性，也必須內嵌。

您可以將「author」插入為 社群元件指南.

使用考量事項 usage-considerations

每個網站在管理用戶端程式庫的方式上都不同。 各種因素包括：