适用于社区组件的Clientlibs clientlibs-for-communities-components

CAUTION
AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

简介 introduction

文档的此部分介绍如何将客户端库(clientlibs)添加到社区组件的页面。

有关基本信息,请访问:

为何需要Clientlibs why-clientlibs-are-required

组件正常运行(JavaScript)和样式(CSS)需要Clientlibs。

当存在 社区功能 对于功能,社区站点中将提供所有必需的组件和配置,包括所需的clientlib。 只有当其他组件可供作者使用时,才需要添加其他clientlib。

当缺少所需的clientlib时, 向页面添加社区组件 可能会导致javascript错误以及意外外观。

示例:未使用Clientlibs进行审阅 example-placed-reviews-without-clientlibs

chlimage_1-244

示例:使用Clientlibs进行审阅 example-placed-reviews-with-clientlibs

chlimage_1-245

确定所需的Clientlib identifying-required-clientlibs

面向开发人员的基本功能信息可识别所需的客户端库。

此外,从AEM实例浏览到 社区组件指南 提供对组件所需clientlib类别列表的访问权限。

例如,在 “审阅”页面 列出的必需clientlibs

  • cq.ckeditor
  • cq.social.hbs.reviews

chlimage_1-246

添加必需的Clientlibs adding-required-clientlibs

当需要向页面添加社区组件时,如果组件尚不存在,则需要为该组件添加所需的clientlib。

使用 CRXDE|Lite 修改社区站点页面的现有clientlibslist。

要为社区站点添加clientlib,请使用 CRXDE Lite:

  • 浏览到 https://<server>:<port>/crx/de

  • 找到 clientlibslist 节点。

    • /content/sites/sample/en/page/jcr:content/clientlibslist
  • 使用 clientlibslist 选定节点

    • 找到字符串[] 属性 scg:requiredClientLibs

    • 选择其 Value 访问字符串数组对话框

      • 根据需要向下滚动

      • 选择 + 输入新的客户端库

        • 重复以添加更多客户端库
      • 选择 确定

    • 选择 全部保存

NOTE
如果网站不是社区网站,则需要发现网站正在使用的客户端库的存在或位置。

使用 开始使用AEM Communities 示例,其中 site-name is 参与,添加审阅组件时,clientliblist的显示方式如下:

chlimage_1-247

recommendation-more-help
5d37d7b0-a330-461b-814d-068612705ff6