Show Menu
TOPICS×

Content Fragment List Component

The Core Component Content Fragment List component allows for the display of a list of content fragments .

Usage

The Core Component Content Fragment List Component allows for the inclusion of a list of content fragments on a page based on a Content Fragment model. This can be especially useful for creating headless content that can be easily consumed by other applications.

Version and Compatibility

The current version of the Content Fragment Component is v1, which was introduced with release 2.4.0 of the Core Components in May 2019, and is described in this document.
The following table details all supported versions of the component, the AEM versions with which the versions of the component is compatible, and links to documentation for previous versions.
Component Version
AEM 6.3
AEM 6.4
AEM 6.5
v1
Compatible
Compatible
Compatible
For more information about Core Component versions and releases, see the document Core Components Versions .

Sample Component Output

To experience the Content Fragment List Component as well as see examples of its configuration options as well as HTML and JSON output, visit the Component Library .

Technical Details

The latest technical documentation about the Content Fragment List Component can be found on GitHub .
Further details about developing Core Components can be found in the Core Components developer documentation .

Configure Dialog

The configure dialog allows the content author to define the which content fragments comprise the list and the elements of those fragments to be included.

Properties Tab

The
Properties
tab defines which Content Fragments are included in the list. This is primarily based on a selected Content Fragment Model, but there are other filter options available.
  • Model
    - Path to the Content Fragment Model on which the list is based.
    • By default, all content fragments of the model defined as
      Model Path
      are included in the list.
  • Parent Path
    - Parent path from which the list should be built.
    • The content fragments based on the selected
      Model Path
      will be filtered to those on the specified
      Parent Path
      .
      • Click or tap the
        Open Selection Dialog
        button at the right side of the field to specify the path.
  • Tags
    - Only the Content Fragments with the specified tags will be included in the list.
    • Click or tap the
      Open Selection Dialog
      button at the right side of the field to specify the tags.
    • Click or tap the X next to selected tags to remove them.
  • Order By
    - Field of the content fragment model by which the list will be ordered
    • Only text fields (including numeric, date, and time) are selectable.
  • Sort Order
    - How the list will be sorted by the
    Order By
    field
    • Ascending or descending
  • Max Items
    - Maximum number of items to be shown in the list
    • No value will return all items.
The
Order By
,
Sort Order
, and
Max Items
options were introduced with release 2.7.0 of the Core Components.

Elements Tab

By default, all elements of the Content Fragment Model will be included in the list (unless limted by the
Max Items
field). The
Elements
tab allows you to specify only specific elements to include.
  • Elements
    - Only the elements of the content fragments in the list specified will appear.
    • Click or tap the
      Add
      button to add a new element.
    • Click or tap the
      Delete
      button to remove a selected element.
    • Drag the
      Order
      handle to rearrange the order of the elements.

Design Dialog

The design dialog allows the template author to define the styles applied to the Content Fragment List Component.