Content Fragment List Component (v1)
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.
- The list and its properties can be selected in the configure dialog.
- Styles can be applied to the component in the design dialog.
Version and Compatibility
The document describes v1 of the Content Fragment Component, which was introduced with release 2.4.0 of the Core Components in May 2019.
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.
- The content fragments based on the selected Model Path will be filtered to those on the specified Parent 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.
-
ID - This option allows to control the unique identifier of the component in the HTML and in the Data Layer.
- If left blank, a unique ID is automatically generated for you and can be found by inspecting the resulting page.
- If an ID is specified, it is the responsibility of the author to make sure that it is unique.
- Changing the ID can have an impact on CSS, JS and Data Layer tracking.
Elements Tab
By default, all elements of the Content Fragment Model will be included in the list (unless limited 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.