內容片段的元件

片段製作元件

注意

不建議擴充或變更片段編輯器中使用的實際元件，因為這些元件仍可能變更。

請參閱 內容片段管理API — 用戶端.

頁面製作元件

注意

此 內容片段核心元件 現在建議使用。 請參閱 開發核心元件 以取得更多詳細資訊。

本節詳細說明傳送以搭配內容片段(內容片段 在 一般 群組)。

注意

另請參閱 轉譯專用內容片段設定元件 以取得更多資訊。

Adobe Experience Manager(AEM)內容片段會建 立並管理為不受頁面影響的資產。它們可讓您建立管道中性內容，以及（可能是管道特定的）變異。 然後，在編寫內容頁面時，您可以使用這些片段及其變體. 您也可以透過 從資產瀏覽器拖曳到頁面 （對於其他以資產為基礎的元件，例如基礎元件影像）。 現成可用的內容片段元件只顯示一個 元素 的URL區段。 使用元件對話方塊，您可以定義 元素、變異和片段段落範圍 顯示在頁面上。

注意

此內容片段元件在AEM 6.2中導入，作為文章元件的增強版本，現已淘汰。

注意

傳統UI不支援內容片段。

定義

此 內容片段 元件可用來保留內容片段資產的參考（有效增強的文字資產）。 內容片段的資源類型為：

dam/cfm/components/contentfragment/contentfragment

引用在屬性中定義：

fileReference

只有觸控式UI的編輯器完全支援內容片段元件，其中包含用戶端程式庫：

cq.authoring.editor.plugin.cfm

此程式庫會新增內容片段專屬的功能至編輯器。 例如，您可在頁面上新增及設定內容片段、在資產瀏覽器中搜尋內容片段資產，以及在側面板中搜尋相關內容，都能獲得支援。

中間內容

此 內容片段 t元件可讓您將其他元件放置在顯示的不同段落之間 元素. 基本上，顯示的元素由不同的段落組成（每個段落都用歸位符標籤）。 您可以在這些段落之間使用其他元件插入內容。

從技術角度來看，顯示的元素* *的每個段落都存在於其自己的parsys中，而您在段落之間新增的每個元件都會（在外罩下）插入parsys中。

換句話說，如果內容片段元件的例項由三個段落組成，則元件在存放庫中會有三個不同的parsys。 新增至內容片段的所有中間內容實際上會位於這些parsys內。

在儲存庫中，中間內容與其在整體段落結構內的位置相關，即它不附加於實際段落內容。

為了說明這一點，讓我們考慮一下：

  • 由三個段落組成的內容片段的例項

  • 第二段後已經插入了一些內容

    • 這表示內容會儲存在第二個parsys中。

基本上，如果此實例的段落結構改變（通過更改所顯示段落的變化、元素或範圍），則可能影響內容片段內容時顯示的中間內容：

  • 編輯，並在第二段前添加另一個段落：

    • 中間內容將顯示在新建立的段落之後（第二個parsys現在保有新建立的段落）。

  • 已編輯且已移除第二段：

    • 中間內容的顯示會在先前是第三個段落的段落之後（第二個parsys現在保有前第三個段落）。

  • 已設定，以便僅顯示第一個段落：

    • 不會顯示中間內容（由於新設定，第二個parsys不再呈現）。

自訂內容片段元件

若要將現成可用的內容片段元件作為擴充的藍圖，您應遵守下列合約：

  • 重複使用HTL轉譯指令碼及其相關的POJO，以了解如何實作介入式內容功能。

  • 重複使用內容片段節點： cq:editConfig

    • 此 afterinsert/ afteredit/ afterdelete 監聽器可用來觸發JS事件。 這些事件將在 cq.authoring.editor.plugin.cfm 用戶端程式庫，以在側面板中顯示相關的內容。
    • 此 cq:dropTargets 已設定為支援拖曳內容片段資產。
    • cq:inplaceEditing 已設定為支援在頁面編輯器中編寫內容片段。 片段就地編輯器定義於 cq.authoring.editor.plugin.cfm 用戶端程式庫，並允許快速連結以開啟目前的 元素/變異 在 片段編輯器.

轉譯前重新寫入資產

「內容片段管理」使用內部轉譯程式，為頁面產生最終HTML輸出。 內容片段元件會在內部使用，也會由更新參考頁面上參考片段的背景程式使用。

在內部，Sling重寫器會用於該轉譯。 各自的設定位於 /libs/dam/config/rewriter/cfm 和可視需要調整。 請參閱 Apache Sling Rewriter 以取得更多資訊。

注意

如果您調整/覆蓋重寫器的配置：

  • /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 並可視需要由自訂元件來運用（例如）。

本頁內容