核心元件嵌入元件允許將外部內容嵌入內AEM容頁中。
核心元件嵌入元件允許內容作者定義要嵌入到內容頁面中的所AEM選外部內容。 此外,還可以選擇定義要嵌入的自由格式HTML。
嵌入元件的當前版本是v2,該版本於2022年2月隨核心元件2.18.0版一同推出,本文檔對此進行了說明。
下表詳細說明了元件的所有受支援版本、AEM元件版本與之相容的版本,以及指向早期版本文檔的連結。
元件版本 | AEM 6.4 | AEM 6.5 | AEM as a Cloud Service |
---|---|---|---|
v2 | - | 相容 | 相容 |
v1 | 相容 | 相容 | 相容 |
有關核心元件版本和版本的詳細資訊,請參閱文檔 核心元件版本。
要體驗嵌入元件,並查看其配置選項以及HTML和JSON輸出的示例,請訪問 元件庫。
有關嵌入元件的最新技術文檔 可在GitHub上找到。
有關開發核心元件的詳細資訊,請參閱 核心元件開發人員文檔。
通過「配置」對話框,內容作者可以定義要嵌入頁面的外部資源。
首先選擇應嵌入的資源類型:
對於每種可嵌入類型,可以定義 ID。 此選項允許控制HTML和 資料層。
最簡單的嵌入方式是URL。 只需貼上要嵌入的資源的URL URL 的子菜單。 該元件將嘗試訪問該資源,如果該資源可由其中一個處理器呈現,則它將在 URL 的子菜單。 否則,將錯誤標籤該欄位。
嵌入式元件隨處理器一起提供,用於以下資源類型:
開發人員可以通過 遵循嵌入元件的開發人員文檔。
嵌入式允許對嵌入式資源進行更多的定製,該嵌入式資源可以參數化並包括附加資訊。 作者可以從預先配置的可信嵌入式中進行選擇,並且元件隨YouTube可嵌入式出廠。
的 可嵌入 欄位定義要使用的處理器類型。 如果是YouTube可侵佔的,您可以定義:
其他可嵌入項將提供類似的欄位,並可由開發者定義 遵循嵌入元件的開發人員文檔。
必須通過 設計對話框 可供頁面作者使用。
可以使用「嵌入元件」將自由格式HTML添加到頁面。
任何不安全標籤(如指令碼)都將從輸入的HTML中篩選,不會在生成的頁面上呈現。
作者可以輸入的HTML標籤會出於安全目的進行篩選,以避免跨站點指令碼攻擊,例如允許作者獲得管理權限。
通常,所有指令碼和 style
元素以及所有 on*
和 style
屬性將從輸出中刪除。
但是,由於嵌入元件遵循全AEM局HTMLAntiSamy衛生框架過濾規則集,因此規則更複雜。 /libs/cq/xssprotection/config.xml
。 如果需要,開發人員可以為項目特定配置覆蓋此內容。
其他安全資訊可在 現場AEM安裝的開發人員文檔 以及 AEMas a Cloud Service安裝。
儘管反薩米衛生框架規則可以通過覆蓋來配置 /libs/cq/xssprotection/config.xml
,這些更改會影響所有HTL和JSP行為,而不僅影響嵌入核心元件。
嵌入元件支AEM持 樣式系統。。
使用下拉框選擇要應用於元件的樣式。 在編輯對話框中所做的選擇與從元件工具欄中選擇的選項具有相同的效果。
必須在 設計對話框 以便下拉菜單可用。
設計對話框允許模板作者定義內容作者可用的選項,內容作者使用「嵌入元件」和放置「嵌入元件」時設定的預設值。