社区组件的Clientlibs

简介

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

有关基本信息,请访问:

为何需要Clientlibs

需要Clientlibs才能使组件正常工作(JavaScript)和样式(CSS)。

当某个功能存在社区函数时,所有必需的组件和配置(包括所需的clientlibs)都将出现在社区站点中。 仅当作者可以使用其他组件时,才需要添加其他客户端库。

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

示例:没有Clientlibs的已放置审阅

置入审阅

示例:Clientlibs的置入审阅

reviews-clientlibs

识别所需的Clientlibs

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

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

例如,在“审阅”页面的最顶部列出所需的clientlibs

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

clientlibs-reviews

添加必需的Clientlibs

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

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

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

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

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

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

    • 找到String[]属性scg:requiredClientLibs

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

      • 如有必要,向下滚动。

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

        • 重复此操作可添加更多客户端库。

        • 选择​确定

    • 选择​全部保存

注意

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

使用AEM Communities快速入门示例(其中site-name为​engage),添加评论组件时,clientliblist的显示方式如下:

审阅组件

在此页面上