內容片段清單元件(v1) content-fragment-list-component
核心元件內容片段清單元件允許顯示清單 內容片段.
使用狀況 usage
核心元件內容片段清單元件允許包含清單 內容片段 在根據內容片段模式的頁面上。 這在建立時特別有用 Headless內容 其他應用程式可輕鬆使用的擴充功能。
版本和相容性 version-and-compatibility
本檔案說明內容片段元件v1,此版本隨2019年5月的核心元件2.4.0版引入。
範例元件輸出 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