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

简介 introduction

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

有关基本信息,请参阅以下内容:

为什么需要Clientlibs why-clientlibs-are-required

组件正常使用(JavaScript)和样式(CSS)需要Clientlibs。

当某个功能存在社区功能时,社区站点中存在所有必需的组件和配置,包括所需的clientlibs。 仅当要向作者提供其他组件时,才必须添加其他clientlibs。

当缺少所需的clientlibs时,将Communities组件添加到页面可能会导致JavaScript错误和意外外观。

示例:置入的审阅没有Clientlibs example-placed-reviews-without-clientlibs

已置入的审核

示例:使用Clientlibs置入审核 example-placed-reviews-with-clientlibs

reviews-clientlibs

标识所需的Clientlibs identifying-required-clientlibs

面向开发人员的基本功能信息可标识所需的clientlibs。

此外,在AEM实例中,浏览到社区组件指南可访问组件所需的clientlib类别列表。

例如,在审阅页面的顶部,列出的必需clientlibs包括

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

clientlibs-reviews

添加所需的Clientlibs adding-required-clientlibs

当需要将Communities组件添加到页面时,如果组件尚不存在,则必须添加该组件所需的clientlibs。

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

要使用CRXDE Lite为社区站点添加clientlib,请执行以下操作:

  • 浏览到https://<服务器>:<端口>/crx/de

  • 找到要添加组件的页面的clientlibslist节点:

    • /content/sites/sample/en/page/jcr:content/clientlibslist
  • 选择clientlibslist节点后:

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

    • 选择其Value,以便访问“字符串数组”对话框。

      • 如有必要,向下滚动。

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

        • 重复以上步骤以添加更多客户端库。

        • 选择​ 确定

    • 选择​ 全部保存

NOTE
如果站点不是社区站点,则必须发现用于该站点的客户端库是否存在或位置。

AEM Communities快速入门为例,其中site-name为​ engage,如果添加审阅组件,则会显示clientliblist:

审阅组件

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791