Componentes para fragmentos de conteúdo
CAUTIONCAUTIONComponentes para criação de fragmentos
CAUTIONConsulte a API de gerenciamento de fragmentos de conteúdo - Lado do cliente.
Componentes para criação de página
CAUTIONOs 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 estes 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 arrastando-o do navegador de ativos para a página (como para outros componentes baseados em ativos, como o componente de base Imagem). O componente de fragmento de conteúdo pronto para uso exibe apenas um elemento do fragmento de conteúdo referenciado. Na caixa de diálogo do componente é possível definir a variável elemento, variação e intervalo de parágrafos de fragmento que você deseja exibir na página.
NOTENOTEDefinição
O Fragmento de conteúdo é usado para manter uma referência a um ativo de fragmento de conteúdo (ativos de texto efetivamente aprimorados). 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 inclui a biblioteca do cliente:
cq.authoring.editor.plugin.cfm
Essa biblioteca adiciona recursos, específicos aos fragmentos de conteúdo, ao editor. Por exemplo, há suporte para a capacidade de adicionar e configurar fragmentos de conteúdo na página, a capacidade de pesquisar por ativos do fragmento de conteúdo no navegador de ativos e por conteúdo associado no painel lateral do .
Conteúdo intermediário
O Fragmento de conteúdo Esse componente permite que você solte componentes adicionais entre os diferentes parágrafos da tela exibida elemento. 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 fica em seu próprio parsys, e cada componente adicionado entre os parágrafos será (sob o capô) inserido nos parsys.
Em outras palavras, se a instância do componente de 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 estará 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 isto, consideremos que temos:
-
Uma instância de um fragmento de conteúdo composto de três parágrafos
-
E que já foi inserido algum conteúdo após o segundo parágrafo
- Isso significa que o conteúdo será armazenado no segundo parsys.
Basicamente, se a estrutura de parágrafo dessa instâ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:
-
É editado e outro parágrafo é adicionado antes do segundo parágrafo:
- O conteúdo intermediário será exibido após o parágrafo recém-criado (o segundo parsys agora retém o parágrafo recém-criado).
-
É editado e o segundo parágrafo é removido:
- O conteúdo intermediário será exibido após o parágrafo que era anteriormente o terceiro (o segundo parsys agora contém o terceiro parágrafo anterior).
-
É configurado de forma que somente o primeiro parágrafo seja exibido:
- O conteúdo intermediário não será exibido (o segundo parsys não é mais renderizado devido à nova configuração).
Personalização do componente do fragmento de conteúdo
Para usar o componente de fragmento de conteúdo pronto para uso como um blueprint para extensão, você deve respeitar o seguinte contrato:
-
Reutilize o script de renderização HTL e seu POJO associado para ver como o recurso de conteúdo intermediário é implementado.
-
Reutilize o nó do fragmento de conteúdo:
cq:editConfig- O
afterinsert/afteredit/afterdeleteos ouvintes são usados para acionar eventos JS. Esses eventos serão tratados na seçãocq.authoring.editor.plugin.cfmbiblioteca do cliente para exibir o conteúdo associado no painel lateral. - O
cq:dropTargetssão configuradas para suportar arrastar ativos de fragmento de conteúdo. cq:inplaceEditingO é configurado para suportar a criação de um fragmento de conteúdo no editor de páginas. O editor de fragmento no local é definido na variávelcq.authoring.editor.plugin.cfmbiblioteca cliente e permite que um link rápido abra o elemento/variação no editor de fragmento.
- O
Regravação de ativos antes da renderização
O Gerenciamento de fragmentos de conteúdo usa um processo de renderização interno para gerar a saída HTML final de uma página. Isso é usado internamente pelo componente Fragmento do 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 configuração respectiva é encontrada em /libs/dam/config/rewriter/cfm e podem ser ajustadas, se necessário. Consulte a Apache Sling Rewriter para obter mais informações.
A configuração pronta para uso usa os seguintes transformadores:
-
transformer-cfm-payloadfilter- para recuperar abodyparte (<body>...</body>) somente do HTML do fragmento -
transformer-cfm-parfilter- filtra parágrafos indesejados se um intervalo de parágrafo for especificado (como pode ser feito com o componente Fragmento de conteúdo) -
transformer-cfm-assetprocessor- é usado internamente para recuperar uma lista dos ativos incorporados ao fragmento
O processo de renderização é exposto por meio de [com.adobe.cq.dam.cfm.content.FragmentRenderService](https://helpx.adobe.com/experience-manager/6-4/sites/developing/using/reference-materials/javadoc/com/adobe/cq/dam/cfm/ContentFragment.html) e podem ser aproveitadas (por exemplo) por componentes personalizados, se necessário.
