客户端自定义 client-side-customization

要自定义客户端上AEM Communities组件的外观和/或行为，有多种方法。

覆盖或扩展组件是两种主要方法。

覆盖组件会更改默认组件并影响对该组件的每个引用。

扩展唯一命名的组件将限制更改的范围。 术语“扩展”与“覆盖”可互换使用。

叠加 overlays

叠加元件是一种对缺省元件进行修改并影响所有使用缺省的实例的方法。

通过修改/apps ​目录中的默认组件副本，而不是修改/libs ​目录中的原始组件来实现覆盖。 组件使用相同的相对路径构建，但“libs”被替换为“apps”除外。

/apps目录是用于解析请求的第一个搜索位置，如果未找到，则使用/libs目录中的默认版本。

不得修改/libs目录中的默认组件，因为将来可以随时使用补丁和升级以维护公共接口所需的任何方式更改/libs目录。

这与扩展默认组件不同，在默认组件中，需要针对特定用途进行修改，创建该组件的唯一路径，并依赖将/libs目录中的原始默认组件作为超级资源类型引用。

有关叠加注释组件的快速示例，请尝试叠加注释组件教程。

扩展名 extensions

扩展（覆盖）组件是一种针对特定用途进行修改的方法，不会影响使用默认组件的所有实例。 扩展组件在/apps文件夹中具有唯一名称，它引用/libs文件夹中的默认组件，因此组件的默认设计和行为不会受到修改。

这与覆盖默认组件不同，在默认组件中，Sling的本质是在搜索libs/文件夹之前解析对apps/文件夹的相对引用，因此组件的设计或行为被全局修改。

有关扩展注释组件的快速示例，请尝试扩展注释组件教程。

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： Forum - 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的clientlibs遵循两个变体的非常特定的命名模式，这些模式仅在类别名称中存在“author”时发生变化：

完成Clientlibs complete-clientlibs

完整的（非创作）clientlib包含依赖项，并且便于与ui：includeClientLib一起使用。

这些版本可在以下位置找到：

例如：

社区组件指南列出了每个SCF组件所需的完整clientlibs。

Clientlibs for Communities组件介绍了如何将clientlibs添加到页面。

创作Clientlibs author-clientlibs

创作版本的clientlibs会被细化到实施组件所需的最小JavaScript。

这些clientlibs绝不应该直接包含在内，而是可以嵌入到为网站手工创建的其他clientlibs中。

这些版本可在SCF libs文件夹中找到：

例如：

注意：虽然创作clientlibs从不嵌入其他库，但它们会列出其依赖项。 嵌入到其他库时，依赖项不会自动拉入，还必须嵌入。

通过将“author”插入为社区组件指南中的每个SCF组件列出的clientlibs，可以识别所需的作者clientlibs。

使用注意事项 usage-considerations

每个网站管理客户端库的方式各不相同。 各种因素包括：