內容片段元件 content-fragment-component

核心元件內容片段元件允許顯示 內容片段.

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

使用狀況 usage

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

版本和相容性 version-and-compatibility

內容片段元件的目前版本是v1,此版本隨2017年10月的核心元件1.1.0版的發佈引入,具體說明見本文。

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

元件版本
AEM 6.4
AEM 6.5
AEM as a Cloud Service
v1
相容於
版本2.17.4 和先前的
相容
相容
NOTE
在2.4.0版之前,內容片段元件位於extensions資料夾中。
apps/core/wcm/extension/components/contentfragment/v1/contentfragment
從2.4.0版開始,此版本已移至下列位置。
apps/core/wcm/components/contentfragment/v1/contentfragment
雖然兩者都是v1,但在升級至版本2.4.0或更新版本的核心元件時,從extensions資料夾使用的任何內容片段元件都必須移轉其相關Proxy元件,才能使用新的資源型別。

如需核心元件版本和發行版本的詳細資訊,請參閱檔案 核心元件版本.

範例元件輸出 sample-component-output

若要體驗內容片段元件並檢視其設定選項範例以及HTML和JSON輸出,請造訪 元件資料庫.

技術細節 technical-details

有關內容片段元件的最新技術檔案 可在GitHub上找到.

有關開發核心元件的進一步詳細資訊,請參閱 核心元件開發人員檔案.

設定對話方塊 configure-dialog

「設定」對話方塊可讓內容作者定義要包含的內容片段及該片段的元素。

屬性標籤 properties-tab

內容片段元件

  • 內容片段

    • 所需內容片段的路徑
    • 選擇對話方塊 可用於定位片段
  • 顯示模式

    • 單一文字元素 — 允許選取一個多行文字元素,並啟用段落控制選項
    • 多個元素 — 允許選取一個或多個所選內容片段的元素
  • 元素 — 要包含的一或多個內容片段元素

  • 變數 — 要使用的內容片段變數(預設為 主版)

  • 段落

    • 全部 — 顯示所有段落

    • 範圍

      • 指定應顯示的段落範圍(以分號分隔)
      • 例如 1;3-5;7;9-* 包含第一段、第三段到第五段、第七段、第九段到最後一段
  • ID — 此選項可讓您控制HTML和中的元件唯一識別碼 資料層.

    • 如果保留為空白,系統會自動為您產生唯一ID,並可透過檢查結果頁面找到該ID。
    • 若指定ID,作者應負責確認該ID是唯一的。
    • 變更ID會對CSS、JS和資料層追蹤造成影響。

段落控制標籤 paragraph-control-tab

此索引標籤在以下情況下無法使用: 多個元素 模式已選取。

內容片段元件

  • 段落 — 允許選取所有段落或一個範圍
  • 將標題處理為它們自己的段落

設計對話方塊 design-dialog

「設計」對話方塊可讓範本作者定義用來處理混合媒體影像和回應式格線的資源型別。

內容片段元件的「設計」對話方塊

  • 內部回應式格線

    • 用於內部回應式格線的Sling資源型別

Adobe使用者端資料層 data-layer

內容片段元件支援 Adobe使用者端資料層。

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c