列表组件 (v2)
利用核心组件列表组件，可以轻松地创建动态和静态列表。
用途
列表组件可用于创建子页面的动态列表或者任意定义项的静态列表。可用的列表类型以及格式化选项可以由模板作者在“设计”对话框中定义。内容编辑者可在“编辑”对话框中从可用列表类型以及如何格式化列表元素中选择。
版本和兼容性
本文档介绍了列表组件 v1，此版本随 2018 年 1 月的核心组件发行版本 2.0.0 的发布引入。
本文档介绍了列表组件 v2。
有关当前版本的列表组件的详细信息，请参阅列表组件文档。
列表中的重定向
如果页面具有重定向目标（无论它指向的是外部 URL 还是另一个 AEM 页面），则包含指向该点的链接的列表将直接指向重定向目标的 URL。
示例
- 创建重定向到页面 B 的页面 A。
- 创建重定向到
https://aemcomponents.dev的页面 C - 在页面 D 上，插入包含页面 A 和 C 的列表组件
- 随后，生成的相应链接将直接指向页面 B 和
https://aemcomponents.dev
示例组件输出
要体验列表组件并查看其配置选项示例以及 HTML 和 JSON 输出，请访问组件库。
技术详细信息
在 GitHub 上可找到有关列表组件的最新技术文档。
在核心组件开发人员文档中可找到有关开发核心组件的其他详细信息。
“编辑”对话框
利用“编辑”对话框，内容作者可以配置列表和列表项。
“列表设置”选项卡
列表可以通过不同方式构建。
不论如何构建列表，始终可以配置排序和 ID 选项。
根据内容作者选择如何构建列表，可以更改其他配置选项。
子页面
列表可以由当前页面的子页面或其他页面构建。
-
父页面
- 其子页面应该用于生成列表的页面
- 留空可使用当前页面
-
子级深度
应该使用层级中向下的多少层
固定列表
列表可使用固定项列表构建。
点击或单击添加按钮可在列表中插入新项。
- 在列表中为项输入文本，或者使用“选择”对话框从 AEM 中选择项。
- 使用拖动手柄重新排列列表中的项。
- 使用垃圾桶图标可删除列表中的项。
搜索
列表可使用对 AEM 内容搜索的结果来构建。
- 搜索查询
用于运行全文搜索以生成列表项的字符串 - 搜索范围
运行搜索的位置- 使用“选择”对话框可在 AEM 中选择位置
- 如果留空则使用当前页面
标记
列表可以使用在特定位置下与特定标记匹配的页面构建。
- 父页面
开始标记匹配的位置- 使用“选择”对话框可在 AEM 中选择位置
- 如果留空则使用当前页面
- 标记
应该匹配的标记- 使用浏览对话框选择标记。
- 匹配
定义用什么类型的匹配来限定可以包括在列表中的页面- 任何标记
- 所有标记
排序选项
不论您选择如何构建列表，始终可以定义特定的排序选项。
- 排序方式
应该如何对元素排序- 标题
- 上次修改日期
- 排序顺序
对项排序所用的顺序- 升序
- 降序
- 最大项数
列表中显示的项的最大数量。- 留空可返回所有项。
- ID - 利用此选项，可以控制 HTML 和 Data Layer 中的组件的唯一标识符。
- 如果留空，系统会自动为您生成一个唯一 ID，可以通过检查结果页面找到该 ID。
- 如果指定一个 ID，作者有责任确保它是唯一的。
- 更改此 ID 会对 CSS、JS 和 Data Layer 跟踪产生影响。
“项设置”选项卡
使用“项设置”选项卡，可以配置列表元素的格式化。
- 链接项
将项链接到对应的页面 - 显示描述
显示链接项的描述 - 显示日期
显示链接项的修改日期
“设计”对话框
模板作者可以使用“设计”对话框定义允许内容作者使用什么类型的列表以及可用的项设置。
列表设置
在列表设置选项卡上，可以定义日期格式以及在组件中什么类型的列表可供内容作者使用。
- 日期格式
用于显示上次修改日期的格式 - 禁用子级
禁用组件中的子级列表类型 - 禁用静态
禁用组件中的静态列表类型 - 禁用搜索
禁用组件中的搜索列表类型 - 禁用标记
禁用组件中的标记列表类型
项设置
在项设置选项卡上，可以定义在组件中可供内容作者使用的单独列表元素的格式化选项。
“样式”选项卡
图像组件支持 AEM 样式系统。
Adobe Client Data Layer
列表组件支持 Adobe Client Data Layer。
Business.Adobe.com 资源
