內容片段清單元件

核心元件內容片段清單元件允許顯示內容片段的清單。

使用狀況

核心元件內容片段清單元件允許基於內容片段模型在頁面上包含內容片段的清單。 這對於建立其他應用程式可輕鬆使用的無頭內容特別有用。

版本和相容性

目前的內容片段元件版本為v1,此版本於2019年5月隨核心元件2.4.0版推出,並在本檔案中加以說明。

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

元件版本 AEM 6.4 AEM 6.5 AEM as a Cloud Service
v1 相容 相容 相容

有關核心元件版本和版本的詳細資訊,請參閱文檔核心元件版本

元件輸出示例

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

技術詳細資訊

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

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

配置對話框

設定對話方塊可讓內容作者定義要包含清單的內容片段以及這些片段的元素。

屬性標籤

屬性​標籤定義清單中包含哪些內容片段。 這主要是以選取的內容片段模型為基礎,但有其他可用的篩選選項。

內容片段清單元件的編輯對話框的屬性頁籤

  • 模型 -清單所依據之內容片段模型的路徑。
    • 預設情況下,定義為​Model Path​的模型的所有內容片段都包括在清單中。
  • 父路徑 -應從中構建清單的父路徑。
    • 基於所選​模型路徑​的內容片段將被過濾為指定​父路徑​上的內容片段。
      • 按一下或點選欄位右側的​開啟選擇對話框​按鈕以指定路徑。
  • 標籤 -清單中只會包含具有指定標籤的內容片段。
    • 按一下或點選欄位右側的​開啟選擇對話方塊​按鈕,以指定標籤。
    • 按一下或點選選取標籤旁的X以移除標籤。
  • Order By -內容片段模型的欄位,清單將依此欄位排序
    • 只有文字欄位(包括數值、日期和時間)可供選取。
  • 排序順序 -如何按順序按字 段排
    • 遞增或遞減
  • 最大項目 -清單中要顯示的項目數上限
    • 沒有值會傳回所有項目。
  • ID —— 此選項可控制HTML和資料層中元件的唯一 識別碼
    • 如果保留空白,則會自動為您產生唯一ID,並透過檢查產生的頁面找到。
    • 如果指定ID,則作者有責任確保其唯一性。
    • 變更ID可能會影響CSS、JS和資料圖層追蹤。
注意

核心元件2.7.0版中引入了​排序依據排序順序​和​最大項目​選項。

元素標籤

依預設,「內容片段模型」的所有元素都會包含在清單中(除非受​最大項目​欄位限制)。 Elements​標籤允許您僅指定要包含的特定元素。

內容片段清單元件編輯對話方塊的「元素」索引標籤

  • Elements —— 只會顯示指定清單中內容片段的元素。
    • 按一下或點選「新增​」按鈕以新增元素。
    • 按一下或點選​Delete​按鈕以移除選取的元素。
    • 拖動​Order​控制代碼以重新排列元素的順序。

設計對話框

設計對話框允許模板作者定義應用於內容片段清單元件的樣式。

本頁內容