內容片段清單元件

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

使用狀況

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

版本與相容性

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

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

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

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

範例元件輸出

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

技術詳細資訊

如需內容片段清單元件的最新技術檔案,請參閱GitHub

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

配置對話框

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

屬性標籤

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

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

  • 模型 — 清單所依據之內容片段模型的路徑。
    • 依預設,定義為​模型路徑​之模型的所有內容片段都會包含在清單中。
  • 父路徑 — 應建立清單的父路徑。
    • 根據所選​模型路徑​的內容片段將篩選為指定​父路徑​上的內容片段。
      • 按一下或點選欄位右側的​開啟選取對話方塊​按鈕,以指定路徑。
  • 標籤 — 清單中只會包含具有指定標籤的內容片段。
    • 按一下或點選欄位右側的​開啟選取對話方塊​按鈕,以指定標籤。
    • 按一下或點選所選標籤旁的X以移除這些標籤。
  • 排序依據 — 內容片段模型的欄位,依此欄位排序清單
    • 只能選取文字欄位(包括數值、日期和時間)。
  • 排序順序 — 依「順序」欄位排序清單 的方
    • 遞增或遞減
  • 項目數上限 — 要在清單中顯示的項目數上限
    • 沒有值將返回所有項目。
  • ID — 此選項可控制HTML和資料層中元件的唯一 識別碼
    • 若保留為空白,系統會自動為您產生唯一ID,並且可透過檢查產生的頁面來找到。
    • 若已指定ID,則作者應負責確認其唯一。
    • 變更ID可能會影響CSS、JS和資料層追蹤。
注意

核心元件2.7.0版推出了​Order BySort Order​和​Max Items​選項。

元素標籤

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

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

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

設計對話方塊

設計對話方塊可讓範本作者定義套用至內容片段清單元件的樣式。

本頁內容