社区组件指南 community-components-guide
社区组件指南是一款适用于 社会构成框架. 它提供了可用AEM Communities组件或由多个组件构建的更复杂功能的列表。
除了每个组件的基本信息外,本指南还允许对SCF组件/功能的工作方式以及配置或自定义这些组件/功能的方式进行实验。
有关与每个组件相关的开发要点的信息,请参阅 功能和组件要点.
快速入门 getting-started
本指南旨在用于创作(localhost:4502)和发布(localhost:4503)实例的开发安装。
通过浏览到
与社区组件的交互将因以下各项而异:
- 服务器(创作或发布)
- 网站访客是否已登录
- 如果已登录,则分配给成员的权限
- 无论默认SRP是否为, JSRP,正在使用
在创作时,要进入编辑模式,请插入 editor.html
或 cf#
作为服务器名称后的第一个路径段:
主页 home-page
本指南提供了SCF组件列表,这些组件可用于在页面左侧预览和制作原型。
在编辑模式下在创作实例中查看的组件指南:
组件页面 component-pages
从页面左侧的列表中选择一个组件。
指南的主体显示:
创作交互 author-interactions
在创作实例中使用指南时,可以通过打开组件对话框来体验配置组件。 有关开发人员的信息,请参阅 组件和功能要点 ,而对话框设置则在 社区组件 章节。
对于社区组件指南,某些组件对话框设置将覆盖 可包含 切换状态。 要在使用现有资源或动态包含的资源之间进行切换,请在编辑模式下选择组件和可包含文本,然后双击以打开编辑对话框:
在 模板 选项卡:
-
通过 sling:include 包含子组件
如果未选中此选项,组件指南将使用存储库中的现有资源(作为par节点子项的jcr节点)。
- 显示的文本为:“此组件通过其par节点包含。”
如果选中此项,组件指南将使用sling动态包含子节点resourceType(非现有资源)的组件。
- 显示的文本为:“此组件是动态包含的。”
默认为未选中。
发布交互 publish-interactions
在发布实例上使用指南时,可以将组件和功能作为站点访客(未登录)以及登录时具有各种权限的成员进行体验。
客户端库 client-side-libraries
每个组件的客户端库(clientlibs)都列出了这些库 必需 将组件放置到页面上时引用的对象。 clientlibs提供了一种管理和优化用于在浏览器中呈现组件的Javascript和CSS下载的方法。
有关更多信息,请访问 适用于社区组件的Clientlibs.
模拟 impersonation
在创作实例中,如果某个组件通常以管理员或开发人员身份登录,则要体验该组件以其他用户身份登录,请使用 模拟 按钮键入用户名或从下拉列表中选择,然后单击按钮。 单击还原以注销并结束模拟。
发布实例不需要模拟。 只需使用登录/注销链接来模拟各种用户,例如 演示用户.
自定义 customization
启用后,每个SCF组件都可通过临时修改组件的模板、CSS和数据来为可能的自定义设置制作原型。
启用自定义 enabling-customization
要快速试用自定义设置,请 scg:showIde
必须将属性添加到组件页面的内容JCR节点中,并将设置为true。
以注释组件为例,在创作实例或发布实例上,使用管理员权限登录:
-
浏览到 CRXDE Lite
-
选择组件的
jcr:content
节点例如,
/content/community-components/en/comments/jcr:content
-
添加资产
- 名称
scg:showIde
- 类型
String
- 值
true
- 名称
-
选择 全部保存
-
在指南中重新加载注释页面
http://localhost:4503/content/community-components/en/comments.html
-
请注意,现在有3个用于“模板”、“CSS”和“数据”的选项卡。
“模板”选项卡 templates-tab
选择模板选项卡可查看与组件关联的模板。
模板编辑器允许编译本地编辑内容并将其应用于页面顶部的示例组件实例,而不会影响存储库中的组件。
在本地编辑中运行编译时,将突出显示所有错误,方法是在边栏中放置一个圆点,并将文本标记为红色。
CSS选项卡 css-tab
选择“CSS”选项卡可查看与组件关联的CSS。
如果组件是多个组件的组合,则某些CSS可能会列在其他组件之一下。
CSS编辑器允许修改CSS并将其应用于页面顶部的示例组件实例。
可通过单击装订线中规则旁边的,选择规则以使用该规则突出显示DOM的各个部分。
“数据”选项卡 data-tab
选择“数据”选项卡以显示.social.json端点数据。 此数据是可编辑的,并且会应用于示例组件实例。
语法错误可能会标记在边栏中,也会在编辑器中突出显示。