嵌入组件 embed-component

利用核心组件嵌入组件，可以在 AEM 内容页面中嵌入外部内容。

用途 usage

利用核心组件嵌入组件，内容作者可以将所选外部内容定义为嵌入到 AEM 内容页面中。此外，还有一个选择，即定义嵌入的自由格式的 HTML。

版本和兼容性 version-and-compatibility

嵌入组件的当前版本是 v2，此版本随 2022 年 2 月的核心组件发行版 2.18.0 的发布引入，具体说明见本文。

下表详细说明了该组件的所有受支持版本、与该组件的版本兼容的 AEM 版本以及指向早期版本文档的链接。

有关核心组件版本的更多信息，请参阅文档核心组件版本。

示例组件输出 sample-component-output

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

技术详细信息 technical-details

在 GitHub 上可找到有关嵌入组件的最新技术文档。

在核心组件开发人员文档中可找到有关开发核心组件的其他详细信息。

“配置”对话框 configure-dialog

利用“配置”对话框，内容作者可以定义要在页面上嵌入的外部资源。

“属性”选项卡 properties-tab

首先选择要嵌入什么类型的资源：

对于每种可嵌入的类型，您可以定义 ID。利用此选项，可以控制 HTML 和 Data Layer 中的组件的唯一标识符。

URL url

最简单的嵌入是 URL。只需将待嵌入资源的 URL 粘贴到 URL 字段中。组件将尝试访问资源，如果它可以由处理程序之一渲染，则会在 URL 字段下显示确认消息。如果不能，该字段将标记为出错。

嵌入组件附带了用于以下资源类型的处理程序：

开发人员可以按照嵌入组件的开发人员文档，添加额外的 URL 处理程序。

可嵌入内容 embeddable

可嵌入内容允许对嵌入的资源进行更多的自定义，这些自定义可以参数化并包括额外信息。作者能够从 YouTube 提供的现成可嵌入内容中，选择预配置的可信可嵌入内容。

可嵌入内容 ​字段定义所要使用的处理程序的类型。在使用 YouTube 可嵌入内容时，您可以定义：

其他可嵌入内容将提供类似的字段，并可由开发人员按照嵌入组件的开发人员文档定义。

HTML html

您可以使用嵌入组件将自由格式的 HTML 添加到页面。

安全性 security

出于安全目的，作者可以输入的 HTML 标记将筛选掉，以避免跨站点脚本攻击，例如，此类攻击可允许作者获取管理权限。

一般来说，所有脚本和 style 元素以及 on* 和 style 属性都将从输出中删除。

但是，规则更复杂，因为嵌入组件遵循 AEM 的全局 HTML AntiSamy 净化框架筛选规则集，此规则集可在 /libs/cq/xssprotection/config.xml 中找到。如果需要，这可以由开发人员覆盖以提供项目特定的配置。

其他安全信息可在适用于内部部署安装的 AEM 开发人员文档以及 AEM as a Cloud Service 安装中找到。

“样式”选项卡 styles-tab-edit

嵌入组件支持 AEM 样式系统。

使用下拉菜单选择要应用于该组件的样式。在“编辑”对话框中所做的选择与从组件工具栏中选择的操作效果相同。

必须在“设计”对话框中为此组件配置样式，以便下拉菜单可用。

“设计”对话框 design-dialog

使用“设计”对话框，模板作者可以定义哪些选项可供使用嵌入组件的内容作者使用，以及在放置嵌入组件时的默认设置。

“可嵌入内容类型”选项卡 embeddable-types-tab

“YouTube”选项卡 youtube-tab