Show Menu
主题×

嵌入组件

核心组件嵌入组件允许在AEM内容页面中嵌入外部内容。

使用情况

核心组件嵌入组件允许内容作者定义要嵌入到AEM内容页面中的选定外部内容。 此外,还有一个选项可定义要嵌入的自由形式HTML。
  • 组件的属性可以在配置对话框中 定义
  • 将组件添加到页面时的默认值可以在设计对话框中 定义

版本和兼容性

嵌入组件的当前版本为v1,该版本于2019年9月随核心组件的2.7.0版一起推出,本文档对此进行了说明。
下表详细列出了组件的所有受支持版本、与组件版本兼容的AEM版本,以及指向先前版本的文档的链接。
组件版本
AEM 6.3
AEM 6.4
AEM 6.5
v1
兼容
兼容
兼容
有关核心组件版本和版本的详细信息,请参阅文档核 心组件版本

示例组件输出

要体验嵌入组件以及查看其配置选项的示例以及HTML和JSON输出,请访问组 件库

技术详细信息

有关嵌入组件的最新技术文 档可在GitHub上找到
有关开发核心组件的更多详细信息,请参阅核 心组件开发人员文档

配置对话框

配置对话框允许内容作者定义要嵌入到页面上的外部资源。 首先选择应嵌入的资源类型:

URL

最简单的嵌入方式是URL。 只需粘贴要嵌入到URL字段中的资源的
URL
。 组件将尝试访问资源,如果某个处理器可以渲染该资源,则会在
URL字段下显示确认消息
。 否则,该字段将被标记为错误。
嵌入组件随附以下类型的资源的处理器:
  • 符合Facebook Post、 Instagram 、SoundCloud、Twitter和YouTube等oEmbed标准的资源
  • Pinterest
开发人员可以按照嵌入组件的开 发人员文档添加其他URL处理器。

可嵌入内容

可嵌入式允许对嵌入式资源进行更多自定义,该嵌入式资源可以参数化并包含附加信息。 作者可以从预配置的可信任可嵌入式中进行选择,并且组件随附Youtube可嵌入式现成版本。
“可
嵌入
”字段定义要使用的处理器类型。 如果是YouTube可嵌入,您随后可以定义:
  • 视频ID
    —— 要嵌入的资源的YouTube中的唯一视频ID
  • 宽度
    -嵌入视频的宽度
  • 高度
    -嵌入视频的高度
其他可嵌入式组件将提供类似的字段,开发人员可以根据嵌入 组件的开发人员文档进行定义。
必须通过“设计”对话框在模板级别启 用可嵌入 ,才能让页面作者使用。

HTML

您可以使用嵌入组件将自由格式的HTML添加到页面。
任何不安全的标记(如脚本)都将从输入的HTML中筛选,并且不会在生成的页面上呈现。

安全

作者可以输入的HTML标记会出于安全目的进行筛选,以避免跨站点脚本攻击,例如允许作者获得管理权限。
通常,所有
script和元素
style
,以及所有
on*``style
和属性都将从输出中删除。
但是,这些规则更复杂,因为嵌入组件遵循AEM的全局HTML AntiSamy卫生框架过滤规则集(可在上找到)
/libs/cq/xssprotection/config.xml
。 如果需要,开发人员可以覆盖该配置以进行特定于项目的配置。
AEM开发人员文档中提供了其他安 全信息。
尽管可以通过覆盖来配置AntiSamy卫生框架规则,但这些更改会影响所有HTL和JSP行为,而不仅仅影响嵌入核心组件
/libs/cq/xssprotection/config.xml

设计对话框

设计对话框允许模板作者定义内容作者可以使用嵌入组件的选项以及放置嵌入组件时设置的默认值。
  • 禁用URL
    —— 在选择内
    容作者时
    ,禁用URL选项
  • 禁用可嵌入
    -在选择内容作
    者时,禁用“可嵌入
    ”选项,而不管允许哪个可嵌入处理器。
  • 禁用HTML
    —— 在选中
    时禁用内容作者的HTML
    选项。
  • 允许的可嵌入
    -定义内容作者可以使用哪些可嵌入处理器的多选项,前提是“可
    嵌入
    ”选项处于活动状态。