列出元件

核心元件清單元件可輕鬆建立動態及靜態清單。

使用狀況

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

清單中的重新導向

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

範例

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

版本與相容性

目前的清單元件版本為v2，已於2018年1月隨核心元件2.0.0版推出，本檔案將加以說明。

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

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

範例元件輸出

若要體驗清單元件以及查看其設定選項的範例以及HTML和JSON輸出，請造訪元件程式庫。

技術詳細資訊

如需清單元件的最新技術檔案，請參閱GitHub。

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

編輯對話方塊

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

清單設定索引標籤

清單可以以不同的方式建置。

• 子頁面
• 固定清單
• 搜尋
• 標記

無論清單是如何建立的，都有可始終配置的排序和ID選項。

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

子頁面

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

• 父頁面

  • 應建立其子頁清單的頁
  • 留空即可使用目前頁面

• 子級深
  度應使用層次中向下多少個級別

固定清單

可使用固定的項目清單來建立清單。

點選或按一下​Add​按鈕，將新項目插入清單。

• 在清單中輸入項的文本，或使用​選擇對話框​從AEM中選擇項。
• 使用拖動控點重新排列清單中的項目。
• 使用垃圾桶圖示來刪除清單中的項目。

搜尋

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

• 搜
  索查詢將運行全文搜索以生成清單元素的字串
• 在中
  搜索應該運行搜索的位置
  • 使用​選擇對話框​選擇AEM中的位置
  • 留空時，請使用目前頁面

標記

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

• 上層
  頁面標籤相符的開始位置
  • 使用​選擇對話框​選擇AEM中的位置
  • 留空時，請使用目前頁面
• ​
  標籤應符合的標籤
  • 使用​Browse​對話方塊來選取標籤
• ​
  符合定義哪些符合類型應該允許將頁面包含在清單中
  • 任何標記
  • 所有標記

排序選項

無論您選擇以何種方式建立清單，都有可一律定義的特定排序選項。

• 依
  順序元素的順序
  • 標題
  • 上次修改日期
• 排
  序順序應排序項的順序
  • 升序
  • 降序
• 最大
  項目數清單中顯示的項目數上限。
  • 保留為空以傳回所有項目。
• ID — 此選項可控制HTML和資料層中元件的唯一 識別碼。
  • 若保留為空白，系統會自動為您產生唯一ID，並且可透過檢查產生的頁面來找到。
  • 若已指定ID，則作者應負責確認其唯一。
  • 變更ID可能會影響CSS、JS和資料層追蹤。

項目設定標籤

使用「項目設定」頁簽，可以配置清單元素的格式。

• 連結
  項目連結項目至對應的頁面
• 顯示
  說明顯示連結項目的說明
• 顯示
  連結項目的DateShow修改日期

設計對話方塊

設計對話方塊可讓範本作者定義內容作者應允許的清單類型以及可用的項目設定。

清單設定

在​清單設定​標籤中，可定義日期格式，以及內容作者可在元件中使用哪些類型的清單。

• 用
  於顯示上次修改日期的Date Format
• 禁用
  子項禁用元件中的子項清單類型
• 停
  用靜態禁用元件中的靜態清單類型
• 禁用
  搜索禁用元件中的搜索清單類型
• 停用
  標籤禁用元件中的標籤清單類型

項目設定

在​項目設定​標籤中，可以定義內容作者應在元件中可用的個別清單元素的格式選項。

• 連結
  項目在編輯對話方塊中啟用連結 項目選項
• 顯示
  說明在編輯對話方塊中啟用顯示說 明選項
• 在編
  輯對話方塊中顯示日期啟用顯 示日期選項

樣式標籤

影像元件支援AEM 樣式系統。

Adobe用戶端資料層

清單元件支援Adobe客戶端資料層。