列出元件 list-component

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
核心組件

建立對象：

開發人員
管理員
使用者

核心元件清單元件可讓您輕鬆建立動態和靜態清單。

使用情況 usage

例如，清單元件可用於建立子頁面的動態清單或任意定義專案的靜態清單。範本作者可在設計對話方塊中定義可用的清單型別和格式選項。內容編輯者可以在編輯對話方塊中，從可用的清單型別以及如何格式化清單元素中選取。

版本和相容性 version-and-compatibility

清單元件的目前版本是v4，此版本隨2023年2月的核心元件發行版本2.22.0的發佈引入，具體說明見本文。

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

元件版本

AEM 6.4

AEM 6.5

AEM as a Cloud Service

相容

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

清單中的重新導向 redirects

當頁面具有重新導向目標時(無論它指向的是外部URL還是另一個AEM頁面)，則包含指向該點的連結的清單將直接指向重新導向目標的URL。

範例 redirect-example

建立重新導向至頁面B的頁面A。
建立重新導向至https://aemcomponents.dev的頁面C
在頁面D上，插入包含頁面A和C的清單元件
接著產生的個別連結會直接指向頁面B和https://aemcomponents.dev

範例元件輸出 sample-component-output

若要體驗清單元件並檢視其設定選項範例以及HTML和JSON輸出，請造訪元件資料庫。

技術細節 technical-details

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

在核心元件開發人員檔案中可找到有關開發核心元件的進一步詳細資料。

編輯對話方塊 edit-dialog

編輯對話方塊可讓內容作者設定清單和清單專案。

清單設定標籤 list-settings-tab

清單可透過不同方式建立。

子頁面
固定清單
搜尋
標記

無論清單的建置方式為何，一律可以設定排序和ID選項。

清單元件的編輯對話方塊

視內容作者選擇建立清單的方式而定，其他設定選項將會變更。

子頁面 child-pages

清單可由目前頁面或其他頁面的子頁面建置。

子頁面選項

父頁面
- 其子頁面應該產生清單的頁面
- 留空將使用目前頁面
子項深度
應該使用階層中向下的層級數

固定清單 fixed-list

清單可使用固定專案清單建立。

固定清單選項

點選或按一下新增按鈕，將新專案插入清單。

在連結欄位中，輸入
- 完整URL
- 現有AEM內容的相對URL
  - 您可以使用 選取範圍對話方塊 從AEM中選擇專案。
在文字欄位中，輸入清單中連結顯示的文字。
如果連結應在新的瀏覽器分頁中開啟，請核取核取方塊

一旦為清單建立了多個專案，您就可以排列清單。

使用拖曳控點來重新排列清單中的專案。
使用垃圾桶圖示可刪除清單中的專案。

搜尋 search-options

清單可使用搜尋AEM內容的結果來建立。

搜尋清單選項

搜尋查詢
執行全文檢索搜尋以產生清單元素的字串
搜尋
應在何處執行搜尋
- 使用 選取範圍對話方塊 在AEM中選擇位置
- 如果留空則使用目前頁面

標記 tags

清單可使用在特定位置下符合特定標籤的頁面來建立。

標籤清單選項

父頁面
開始標籤比對的位置
- 使用 選取範圍對話方塊 在AEM中選擇位置
- 如果留空則使用目前頁面
標籤
應該比對哪些標籤
- 使用瀏覽對話方塊來選取標籤
符合
定義用什麼相符型別來限定要包含在清單中的頁面
- 任何標籤
- 所有標籤

排序選項 sort-options

無論您選擇如何建立清單，都可隨時定義特定的排序選項。

排序選項

排序依據
應該如何排序元素
- 標題
- 上次修改日期
排序順序
專案應排序的順序
- 遞增
- 降序
最大專案
在清單中顯示的最大專案數。
- 留空將傳回所有專案。
ID — 此選項可控制HTML和資料層中元件的唯一識別碼。
- 如果保留為空白，系統會自動為您產生唯一ID，並可透過檢查結果頁面找到該ID。
- 若指定ID，作者應負責確認該ID為唯一ID。
- 變更ID會對CSS、JS和資料層追蹤造成影響。