社区组件指南

社区组件指南是社交组件框架(SCF)的交互式开发工具。 它提供了可用AEM Communities组件或由多个组件构建的更复杂功能的列表。

除了每个组件的基本信息外，本指南还允许对SCF组件/功能的工作方式以及配置或自定义这些组件/功能的方式进行实验。

有关与每个组件相关的开发要点的信息，请参阅功能和组件要点。

入门

本指南旨在用于创作(localhost:4502)和发布(localhost:4503)实例的开发安装。

通过浏览到

与社区组件的交互将因以下各项而异：

  • 服务器（创作或发布）
  • 网站访客是否已登录
  • 如果已登录，则分配给成员的权限
  • 是否使用默认SRP JSRP

在创作时，要进入编辑模式，请在服务器名称后面插入editor.html或cf#作为第一个路径段：

注意

在编辑模式下进行创作时，页面上的链接不处于活动状态。

要导航到组件页面，请首先选择预览模式以激活链接。

将组件页面显示在浏览器中，返回到编辑模式以打开组件的编辑对话框。

有关一般创作信息，请查看页面创作快速指南。

如果不熟悉AEM，请查看有关基本操作的文档。

主页

本指南提供了SCF组件列表，这些组件可用于在页面左侧预览和制作原型。

在编辑模式下在创作实例中查看的组件指南：

chlimage_1-404

组件页

从页面左侧的列表中选择一个组件。

chlimage_1-405

指南的主体显示：

  1. 标题：所选组件的名称

  2. 客户端库:一个或多个必需类别的列表

  3. 可包含:如果组件可以动态包含，则可以在创作编辑模式下切换状态：

    • 如果添加，则显示的文本为：“此组件通过其par节点包含。”
    • 如果包含，则显示的文本为：“此组件是动态包含的。”
    • 如果不包含，则不会显示任何文本

  4. 示例组件或功能：组件或特征的活动实例。 如果某个组件发生了更改，则可能会对选项卡部分中提供的模板、CSS和数据进行更改。

注意

从左侧进行选择后，当浏览器窗口过窄时，组件将显示在组件列表的下方（而不是旁边）。

创作交互

在创作实例中使用指南时，可以通过打开组件对话框来体验配置组件。 有关开发人员的信息，请参阅文档的组件和功能要点部分，而对话框设置则请参阅社区组件部分，以供作者参考。

对于“社区组件”指南，某些组件对话框设置将覆盖Includable切换状态。 要在使用现有资源或动态包含的资源之间进行切换，请在编辑模式下选择组件和可包含文本，然后双击以打开编辑对话框：

chlimage_1-406

在​Templates​选项卡下：

chlimage_1-407

  • 通过 sling:include 包含子组件

    如果未选中此选项，组件指南将使用存储库中的现有资源（作为par节点子项的jcr节点）。

    • 显示的文本为：“此组件通过其par节点包含。”

    如果选中此项，组件指南将使用sling动态包含子节点resourceType（非现有资源）的组件。

    • 显示的文本为：“此组件是动态包含的。”

    默认为未选中。

发布交互

在发布实例上使用指南时，可以将组件和功能作为站点访客（未登录）以及登录时具有各种权限的成员进行体验。

注意

请注意，如果SRP默认为JSRP，则在发布实例上输入的UGC将仅在发布时可见，并且将*不会从创作实例上的审核控制台中可见。

客户端库

每个组件的客户端库(clientlibs)是在将组件放置到页面上时需要引用的那些​必需的​库。 clientlibs提供了一种管理和优化用于在浏览器中呈现组件的Javascript和CSS下载的方法。

有关更多信息，请访问Clientlibs for Communities Components。

模拟

在作者实例中，如果一个用户通常以管理员或开发人员身份登录，要体验以其他用户身份登录的组件，请使用​模拟​按钮左侧的文本框键入用户名或从下拉列表中选择，然后单击按钮。 单击还原以注销并结束模拟。

发布实例不需要模拟。 只需使用登录/注销链接来模拟各种用户，例如演示用户。

自定义

启用后，每个SCF组件都可通过临时修改组件的模板、CSS和数据来为可能的自定义设置制作原型。

启用自定义

注意

此工具为只读。对模板、CSS或数据所做的任何编辑都不会保存到存储库。

要快速体验自定义设置，必须将scg:showIde属性添加到组件页面的内容JCR节点并设置为true。

以注释组件为例，在创作实例或发布实例上，使用管理员权限登录：

  1. 浏览到CRXDE Lite

    例如， http://localhost:4503/crx/de

  2. 选择组件的jcr:content节点

    例如，/content/community-components/en/comments/jcr:content

  3. 添加资产

    • 名称 scg:showIde
    • 类型 String
    • 值 true

  4. 选择​Save All

  5. 在指南中重新加载注释页面

    http://localhost:4503/content/community-components/en/comments.html

  6. 请注意，现在有3个用于“模板”、“CSS”和“数据”的选项卡。

chlimage_1-408 chlimage_1-409

“模板”选项卡

选择模板选项卡可查看与组件关联的模板。

模板编辑器允许编译本地编辑内容并将其应用于页面顶部的示例组件实例，而不会影响存储库中的组件。

在本地编辑中运行编译时，将突出显示所有错误，方法是在边栏中放置一个圆点，并将文本标记为红色。

CSS选项卡

选择“CSS”选项卡可查看与组件关联的CSS。

如果组件是多个组件的组合，则某些CSS可能会列在其他组件之一下。

CSS编辑器允许修改CSS并将其应用于页面顶部的示例组件实例。

可通过单击装订线中规则旁边的，选择规则以使用该规则突出显示DOM的各个部分。

数据选项卡

选择“数据”选项卡以显示.social.json端点数据。 此数据是可编辑的，并且会应用于示例组件实例。

语法错误可能会标记在边栏中，也会在编辑器中突出显示。

在此页面上