Componente Fragmento de Conteúdo

Última atualização: 28 de abril de 2025

Criado para:

  • Desenvolvedor
  • Administrador
  • Usuário

O componente Fragmento do Conteúdo, dos Componentes Principais, permite a exibição de um fragmento de conteúdo.

NOTE
Antes da versão 2.4.0 dos Componentes Principais, o componente Fragmento de Conteúdo estava disponível como uma extensão para os Componentes Principais e precisava ser baixado separadamente e ativado explicitamente.

Uso

O componente Fragmento de Conteúdo, dos Componentes Principais, permite a inclusão de um fragmento de conteúdo em uma página.

Versão e compatibilidade

A versão atual do componente Fragmento de Conteúdo é a v1, introduzida com a versão 1.1.0 dos Componentes Principais em outubro de 2017, e está descrita neste documento.

A tabela a seguir detalha todas as versões compatíveis do componente, as versões do AEM com as quais as versões do componente são compatíveis e os links para a documentação das versões anteriores.

Versão do componenteAEM 6.4AEM 6.5AEM 6.5 LTSAEM as a Cloud Service
v1Compatível com a
versão 2.17.4 e anteriores		CompatívelCompatívelCompatível
NOTE
Antes da versão 2.4.0, o componente Fragmento de Conteúdo estava localizado na pasta de extensões:
apps/core/wcm/extension/components/contentfragment/v1/contentfragment
A partir da versão 2.4.0, ele foi movido para o seguinte local:
apps/core/wcm/components/contentfragment/v1/contentfragment
Embora ambos sejam a versão v1, qualquer componente Fragmento de Conteúdo que tenha sido usado da pasta de extensões exigirá uma migração de seus componentes proxy relacionados para usar o novo tipo de recurso ao atualizar para a versão 2.4.0 ou posterior dos Componentes Principais.

Para mais informações sobre as versões dos Componentes Principais, consulte o documento Versões dos Componentes Principais.

Exemplo de saída do componente

Para experimentar o componente Fragmento de Conteúdo, e ver exemplos de suas opções de configuração e de saídas HTML e JSON, visite a Biblioteca de Componentes.

Detalhes técnicos

A documentação técnica mais recente sobre o componente Fragmento de Conteúdo pode ser encontrada no GitHub.

Mais detalhes sobre o desenvolvimento dos Componentes Principais podem ser encontrados na documentação do desenvolvedor dos Componentes Principais.

Caixa de diálogo de configuração

A caixa de diálogo de configuração permite que o autor de conteúdo defina o fragmento de conteúdo e os elementos desse fragmento a serem incluídos.

Guia Propriedades

Componente Fragmento de Conteúdo

  • Fragmento de conteúdo

    • Caminho para o fragmento de conteúdo desejado
    • A Caixa de diálogo de Seleção pode ser usada para localizar o fragmento

  • Modo de exibição

    • Elemento de texto único - Habilita a seleção de um elemento de texto multilinha e permite as opções de controle de parágrafo
    • Vários elementos - Permite a seleção de um ou mais elementos do fragmento de conteúdo selecionado

  • Elemento - O elemento ou os elementos do fragmento de conteúdo que serão incluídos

  • Variação - Que variação do fragmento de conteúdo usar (o padrão é Principal)

  • Parágrafos

    • Todos - Exibir todos os parágrafos

    • Intervalo

      • Para especificar intervalos de parágrafos que devem ser exibidos, separados por ponto e vírgula
      • Por exemplo 1;3-5;7;9-* para incluir o primeiro parágrafo, do terceiro ao quinto parágrafo, o sétimo e do nono ao último parágrafo

  • ID - Essa opção permite controlar o identificador exclusivo do componente no HTML e na Camada de Dados.

    • Caso deixado em branco, um ID exclusivo é gerado automaticamente para você e pode ser encontrado ao inspecionar a página resultante.
    • Se um ID for especificado, é responsabilidade do autor garantir que ele seja exclusivo.
    • A alteração do ID pode afetar o rastreamento de CSS, JS e da Camada de Dados.