內容片段清單元件(v1) content-fragment-list-component

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

使用狀況 usage

核心元件內容片段清單元件允許包含清單 內容片段 在根據內容片段模式的頁面上。 這在建立時特別有用 Headless內容 其他應用程式可輕鬆使用的擴充功能。

版本和相容性 version-and-compatibility

本檔案說明內容片段元件v1,此版本隨2019年5月的核心元件2.4.0版引入。

CAUTION
本檔案說明內容片段清單元件v1。
如需目前版本的內容片段清單元件的詳細資訊,請參閱 內容片段清單元件 檔案。

範例元件輸出 sample-component-output

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

技術細節 technical-details

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

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

設定對話方塊 configure-dialog

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

屬性標籤

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

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

  • 模型 — 清單所根據的內容片段模式的路徑。

    • 根據預設,模型的所有內容片段定義為 模型路徑 包含在清單中。
  • 父路徑 — 應從中建立清單的父路徑。

    • 根據所選的內容片段 模型路徑 將會篩選為指定上的專案 父路徑.
      • 按一下或點選 開啟選取範圍對話方塊 欄位右側的按鈕,指定路徑。
  • 標籤 — 只有具有指定標籤的內容片段會包含在清單中。

    • 按一下或點選 開啟選取範圍對話方塊 欄位右側的按鈕,用於指定標籤。
    • 按一下或點選所選標籤旁的X以移除它們。
  • 排序方式 — 清單排序所依據的內容片段模型欄位

    • 只能選取文字欄位(包括數值、日期和時間)。
  • 排序順序 — 清單如何依 排序方式 欄位

    • 遞增或遞減
  • 專案數量上限 — 清單中顯示的最大專案數量

    • 沒有值會傳回所有專案。
  • ID — 此選項可讓您控制HTML和中的元件唯一識別碼 資料層.

    • 如果保留為空白,系統會自動為您產生唯一ID,並可透過檢查結果頁面找到該ID。
    • 若指定ID,作者應負責確認該ID是唯一的。
    • 變更ID會對CSS、JS和資料層追蹤造成影響。
NOTE
排序方式排序順序、和 專案數量上限 核心元件2.7.0版中引進了選項。

元素標籤

依預設,內容片段模式的所有元素將包含在清單中(除非受到以下限制) 專案數量上限 欄位)。 此 元素 tab可讓您僅指定要包含的特定元素。

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

  • 元素 — 只有指定清單中的內容片段元素會出現。

    • 按一下或點選 新增 按鈕來新增元素。
    • 按一下或點選 刪除 按鈕以移除選取的元素。
    • 拖曳 訂購 操作框可重新排列元素的順序。

設計對話方塊 design-dialog

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

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