內容片段元件 content-fragment-component

最後更新： 2026年5月21日

建立對象：

{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

「核心元件內容片段」元件允許顯示內容片段。

NOTE

在核心元件 2.4.0 版之前，內容片段元件可作為核心元件的擴充功能使用，且必須單獨下載並明確啟用。

TIP

您是否考慮過適用於 AEM 的 Edge Delivery Services？

現有的專案可以繼續使用本文件中所述的方法。然而，針對新專案，Adobe 建議採用 Edge Delivery Services。

用途 usage

「核心元件內容片段元件」允許在頁面上包含內容片段。

內容片段元件的目前版本為 v1，此版本於 2017 年 10 月隨著核心元件 1.1.0 版發行導入，詳情請參閱本文件。

下表詳細說明該元件的所有支援版本、與元件版本相容的 AEM 版本，以及舊版文件的連結。

元件版本

AEM 6.4

AEM 6.5

AEM 6.5 LTS

AEM as a Cloud Service

與
2.17.4 版及更早版本相容

相容

NOTE

在版本 2.4.0 之前，內容片段元件位於擴充功能資料夾中。

apps/core/wcm/extension/components/contentfragment/v1/contentfragment

從 2.4.0 版開始，已移至下列位置。

apps/core/wcm/components/contentfragment/v1/contentfragment

雖然兩者都是 v1，但在升級至發行版本 2.4.0 或更新版本的核心元件時，從擴充功能資料夾使用的任何內容片段元件都必須移轉其相關 Proxy 元件，才能使用新的資源類型。

如需核心元件版本和發行版本的進一步詳細資訊，請參閱核心元件版本文件。

若要體驗「內容片段元件」，並檢視其設定選項及 HTML 和 JSON 輸出的範例，請造訪「元件庫」。

在 GitHub 上可找到有關內容片段元件的最新技術文件。

如需開發「核心元件」的進一步詳細資訊，請參閱核心元件開發人員文件。

設定對話框可讓內容作者定義要包含的內容片段和片段元素。

內容片段元件

內容片段
- 所需內容片段的路徑
- 選取對話框可用來尋找片段
顯示模式
- 單一文字元素 - 啟用選取一個多行文字元素，並啟用段落控制選項
- 多個元素 - 允許選取一個或多個所選內容片段的元素
元素 - 要包含的內容片段的一個或多個元素
變化版本 - 要使用的內容片段變化版本 (預設為主版)
段落
- 全部 - 顯示所有段落
- 範圍
  - 指定應顯示的段落範圍，並以分號分隔
  - 例如 1;3-5;7;9-*，以包含第 1 段、第 3 至第 5 段、第 7 段，以及第 9 至最後一段
ID - 此選項可讓您控制 HTML 和資料層中元件的唯一識別碼。
- 如果留空，則會自動產生唯一識別碼，您可以透過檢查得出的頁面找到該 ID。
- 若已指定 ID，則作者應確保其為唯一識別碼。
- 變更該 ID 會對 CSS、JS 和「資料層」追蹤造成影響。