Email Content Fragment Component
The Email Content Fragment component allows for the display of a content fragment in your content.
Usage
The Email Content Fragment Component allows for the inclusion of a content fragment in your email content. Content fragments are multichannel structured content that can be centrally authored and easily reused.
- The fragment and its properties can be selected in the configure dialog.
- Resource types to handle certain images and grids can be defined in the design dialog.
- The edit option opens the selected fragment within the content fragment editor, customized for use with the Email Core Components.
Version and Compatibility
The current version of the Email Content Fragment Component is v1, which was introduced with release X of the Email Core Components in October 2022, 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.
For more information about Email Core Component versions and releases, see the document Email Core Components Versions.
Technical Details
The latest technical documentation about the Email Content Fragment 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 which content fragment and the elements of that fragment to be included.
Properties Tab
-
Content Fragment
- Path to the desired content fragment
- The Selection Dialog can be used to locate the fragment
-
Display Mode
- Single Text Element - Enables selection of one multiline text element and enables paragraph control options
-
Variation - Which variation of the content fragment to use (defaults to Master)
-
ID - This option allows controlling the unique identifier of the component in the HTML.
- If left blank, a unique ID is automatically generated for you and can be found by inspecting the resulting content.
- 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.
Paragraph Control Tab
-
Paragraphs - Allow selection of all paragraphs or a range
-
All - Display all paragraphs
-
Range
- Specify ranges of paragraphs which should be displayed, separated by a semicolon
- For instance
1;3-5;7;9-*to include the first, the third to fifth, the seventh, and the ninth to the final paragraphs
-
-
Handle heading as their own paragraphs
Edit Dialog
Once you have used the Email Content Fragment Component to configure a content fragment, when you select the component in the content editor, it shows an Edit option.
Tapping or clicking the Edit button opens the content fragment editor. The content fragment editor has been extended to include buttons for the Select Adobe Campaign Variable to insert Adobe Campaign variables into your content fragments.
For more information about editing and authoring content fragments, see the document Authoring Fragment Content.
Design Dialog
When an Email Content Fragment Component is configured with a content fragment, when you select it in the content editor, the toolbar reveals a button to open the content fragment editor.
Main Tab
-
Internal responsive grid
- The Sling resource type that is used for the internal responsive grid
Styles Tab
The Email Experience Fragment Component supports the AEM Style System.