不建議擴充或變更片段編輯器中使用的實際元件,因為這些元件仍可能會變更。
請參閱 內容片段管理API — 使用者端.
另請參閱 轉譯專用內容片段設定元件 以取得進一步資訊。
Adobe Experience Manager(AEM)內容片段會建 立並管理為不受頁面影響的資產。它們可讓您建立管道中性內容,連同(可能特定於管道)變數。 接著,您可以在編寫內容頁面時,使用這些片段及其變數. 您也可以透過以下方式使用現有的內容片段資產: 將其從資產瀏覽器拖曳至頁面 (如同其他資產型元件,例如基礎元件影像)。 現成可用的內容片段元件只會顯示一個 元素 所參考的內容片段的。 您可以使用元件對話方塊來定義 元素、變數和片段段落的範圍 要顯示在頁面上的資訊。
此內容片段元件已在AEM 6.2中作為文章元件的增強版本引入,但已淘汰。
傳統UI中不支援內容片段。
此 內容片段 元件是用來儲存內容片段資產的參考(有效地增強文字資產)。 內容片段的資源型別為:
dam/cfm/components/contentfragment/contentfragment
參照是在屬性中定義:
fileReference
只有觸控式UI的編輯器完全支援內容片段元件,其中包括使用者端程式庫:
cq.authoring.editor.plugin.cfm
此程式庫會將內容片段的特定功能新增到編輯器中。 例如,可支援在頁面上新增和設定內容片段的功能、在資產瀏覽器中搜尋內容片段資產的功能,以及側面板中的相關內容。
此 內容片段 t元件可讓您在顯示的不同段落之間放置其他元件 元素. 基本上,顯示的元素由不同的段落組成(每個段落都標有歸位字元)。 在每個段落之間,您可以使用其他元件來插入內容。
從技術觀點來看,所顯示元素的每個段落都位於其自身的parsys中,您在段落之間新增的每個元件都會(在機殼下)插入到parsys中。
換言之,如果內容片段元件的例項由三個段落組成,則元件在存放庫中會有三個不同的parsys。 所有新增至內容片段的中間內容實際上都位於這些parsys內。
在存放庫中,中間內容會相對於其在整體段落結構中的位置儲存,也就是說,它不會附加至實際的段落內容。
為了說明這一點,請考量您有以下事項:
由三個段落組成的內容片段例項
而且有些內容已經插入在第二段之後
基本上,如果此例項的段落結構有所變更(透過變更顯示的變化、元素或段落範圍),可能會影響內容片段內容時顯示的中間內容:
會進行編輯,並在第二段之前新增另一個段落:
已編輯並移除第二段:
設定為只顯示第一段:
若要使用現成的內容片段元件作為擴充的藍圖,您應遵守下列合約:
重複使用HTL演算指令碼及其關聯的POJO,以便檢視中間內容功能的實作方式。
重複使用內容片段節點: cq:editConfig
內容片段管理會使用內部轉譯程式,為頁面產生最終HTML輸出。 這在內部供內容片段元件使用,同時也供在參考頁面上更新參考片段的背景程式使用。
在內部,Sling重寫程式會用於該轉譯。 您可在以下位置找到個別設定: /libs/dam/config/rewriter/cfm
如有必要,可調整和。 請參閱 Apache Sling重寫程式 以取得詳細資訊。
如果您確實調整/覆蓋重寫程式的設定:
/libs/dam/config/rewriter/cfm
然後 serializerType
必須 將更新至:
serializerType="html5-serializer"
現成可用的組態使用下列轉換器:
transformer-cfm-payloadfilter
— 用於擷取 body
部分( <body>...</body>
)僅片段HTML的
transformer-cfm-parfilter
— 如果指定段落範圍,則篩選掉不需要的段落(與內容片段元件一樣)
transformer-cfm-assetprocessor
— 在內部使用,用於擷取內嵌在片段中的資產清單
演算程式會透過以下方式公開 com.adobe.cq.dam.cfm.content.FragmentRenderService
如有必要,自訂元件可使用(例如)和。