Componentes para fragmentos de conteúdo components-for-content-fragments

Componentes para criação de fragmentos components-for-fragment-authoring

Consulte a API de gerenciamento de fragmento de conteúdo — lado do cliente.

Componentes para criação de página components-for-page-authoring

Os fragmentos de conteúdo do Adobe Experience Manager (AEM) são criados e gerenciados como ativos independentes da página. Eles permitem criar conteúdo não vinculado a canais, juntamente com variações (podem ser específicas de cada canal). Em seguida, é possível usar esses fragmentos e suas variações ao criar suas páginas de conteúdo. Também é possível usar um ativo de fragmento de conteúdo existente ao arrastar do navegador de ativos para a página (assim como para outros componentes baseados em ativos, como a Imagem do componente básico). O componente Fragmento de conteúdo pronto para uso exibe apenas um element do fragmento de conteúdo referenciado. Usando a caixa de diálogo de componentes, é possível definir o elemento, variação e intervalo de parágrafos do fragmento que deseja exibir na página.

Definição definition

A variável Fragmento do conteúdo O componente é usado para manter uma referência a um ativo de fragmento de conteúdo (ativos de texto aprimorados efetivamente). O tipo de recurso do fragmento de conteúdo é:

dam/cfm/components/contentfragment/contentfragment

A referência é definida na propriedade:

fileReference

Somente o editor da interface habilitada para toque oferece suporte total aos componentes do fragmento de conteúdo, que incluem a biblioteca do cliente:

cq.authoring.editor.plugin.cfm

Essa biblioteca adiciona recursos, específicos dos fragmentos de conteúdo, ao editor. Por exemplo, o suporte para a capacidade de adicionar e configurar fragmentos de conteúdo na página, a capacidade de pesquisar ativos de fragmento de conteúdo no navegador de ativos e conteúdo associado no painel lateral está disponível.

Conteúdo intermediário in-between-content

A variável Fragmento do conteúdo O componente t permite soltar componentes adicionais entre os diferentes parágrafos do exibido element. Basicamente, o elemento exibido é composto de parágrafos diferentes (cada parágrafo é marcado por um retorno de carro). Entre cada um desses parágrafos, é possível inserir conteúdo usando outros componentes.

De um ponto de vista técnico, cada parágrafo do elemento exibido reside em seu próprio parsys, e cada componente adicionado entre os parágrafos é inserido (abaixo do capô) no parsys.

Em outras palavras, se a instância do componente Fragmento de conteúdo for composta de três parágrafos, o componente terá três parsys diferentes no repositório. Todo o conteúdo intermediário adicionado ao fragmento de conteúdo está realmente localizado dentro desses parsys.

No repositório, o conteúdo intermediário é armazenado em relação à sua posição dentro da estrutura geral do parágrafo, ou seja, não é anexado ao conteúdo real do parágrafo.

Para ilustrar isso, considere que você tem o seguinte:

Basicamente, se a estrutura de parágrafo dessa ocorrência for alterada (alterando a variação, o elemento ou o intervalo de parágrafos exibidos), isso poderá afetar o conteúdo intermediário exibido quando o conteúdo do fragmento de conteúdo:

Personalização do componente Fragmento de Conteúdo customizing-the-content-fragment-component

Para usar o componente Fragmento de conteúdo pronto para uso como um blueprint para a extensão, você deve respeitar o seguinte contrato:

Regravação de ativos antes da renderização asset-rewriting-before-rendering

O gerenciamento de fragmento de conteúdo usa um processo de renderização interno para gerar a saída de HTML final para uma página. Isso é usado internamente pelo componente Fragmento de conteúdo, mas também pelo processo em segundo plano que atualiza os fragmentos referenciados nas páginas de referência.

Internamente, o Sling Rewriter é usado para essa renderização. A respectiva configuração é encontrada em /libs/dam/config/rewriter/cfm e podem ser ajustadas, se necessário. Consulte a Reescrita do Apache Sling para obter mais informações.

A configuração pronta para uso usa os seguintes transformadores:

O processo de renderização é exposto por meio de com.adobe.cq.dam.cfm.content.FragmentRenderService e podem ser usados (por exemplo) por componentes personalizados, se necessário.