Components for Content Fragments components-for-content-fragments

Components for Fragment Authoring components-for-fragment-authoring

See the Content Fragment Management API - Client-Side.

Components for Page Authoring components-for-page-authoring

Adobe Experience Manager (AEM) content fragments are created and managed as page-independent assets. They let you create channel-neutral content, together with (possibly channel-specific) variations. You can then use these fragments, and their variations, when authoring your content pages. You can also use an existing content fragment asset by dragging it from the asset browser to the page (as for other asset-based components, such as the foundation component Image). The out-of-the-box content fragment component displays only one element of the referenced content fragment. Using the component dialog you can define the element, variation and range of fragment paragraphs that you want to display on the page.

Definition definition

The Content Fragment component is used to hold a reference to a content fragment asset (effectively enhanced text assets). The resource type for the content fragment is:

dam/cfm/components/contentfragment/contentfragment

The reference is defined in the property:

fileReference

Only the editor of the touch-enabled UI fully supports content fragment components, which include the client library:

cq.authoring.editor.plugin.cfm

This library adds features, specific to content fragments, to the editor. For example, support for the ability to add and configure content fragments on the page, the ability to search for content fragment assets in the asset browser, and for associated content in the side panel is available.

In-Between Content in-between-content

The Content Fragmen t component lets you drop additional components in-between the different paragraphs of the displayed element. Basically, the element displayed is composed of different paragraphs (each paragraph is marked by a carriage return). Between each of those paragraphs, you can insert content using other components.

From a technical viewpoint, each paragraph of the displayed element lives in its own parsys, and each component that you add in-between the paragraphs are (under the hood) inserted into the parsys.

In other words, if the instance of the content fragment component is composed of three paragraphs, then the component has three different parsys in the repository. All the in-between content that is added to the content fragment is actually be located inside these parsys.

In the repository, the in-between content is stored relative to its position inside the overall paragraph structure, that is, it is not attached to the actual paragraph content.

To illustrate this, consider that you have the following:

Basically, if the paragraph structure of this instance changes (by changing the variation, element, or range of paragraphs displayed), it could affect the in-between content displayed when the content fragment content:

Customizing the Content Fragment Component customizing-the-content-fragment-component

To use the out-of-the-box content fragment component as a blueprint for extension you should respect the following contract:

Asset Rewriting Before Rendering asset-rewriting-before-rendering

Content Fragment Management uses an internal rendering process to generate the final HTML output for a page. This is used internally by the Content Fragment component, but also by the background process that updates referenced fragments on referencing pages.

Internally, the Sling Rewriter is used for that rendering. The respective configuration is found at /libs/dam/config/rewriter/cfm and can be adjusted, if necessary. See the Apache Sling Rewriter for more information.

The out-of-the-box configuration uses the following transformers:

The rendering process is exposed through com.adobe.cq.dam.cfm.content.FragmentRenderService and can be used (for example) by custom components, if necessary.