Show Menu
TOPICS×

Componente do fragmento de experiência

O Componente principal de fragmento de experiência do componente permite que o autor do conteúdo insira uma variação de fragmento de experiência em uma página e ao mesmo tempo suporte uma estrutura de site localizada.

Uso

O Componente principal de fragmento de experiência do componente permite que o autor do conteúdo selecione as variações do fragmento de experiência existente e insira uma na página de conteúdo. O componente Fragmento de experiência também suporta uma estrutura de site localizada.

Suporte à estrutura do site localizada

O Componente do fragmento de experiência é adaptável às estruturas do site localizadas e renderiza o fragmento de experiência apropriado com base na localização da página. Para fazer isso, o fragmento de experiência deve atender às seguintes condições.
  • O componente Fragmento de experiência é adicionado a um modelo.
  • Esse modelo é usado para criar uma nova página de conteúdo que faz parte de uma estrutura localizada abaixo
    /content/<site>
    .
  • O fragmento de experiência referenciado em uma página de conteúdo faz parte de uma estrutura de fragmento de experiência localizada abaixo que segue os mesmos padrões do site abaixo,
    /content/experience-fragments
    /content/<site>
    incluindo o uso dos mesmos nomes de componentes.
Nesse caso, o fragmento com a mesma localização (idioma, blueprint ou live copy) da página atual será renderizado como parte do modelo.
Esse comportamento é limitado aos Componentes do fragmento de experiência adicionados aos modelos. Fragmento de experiênciaOs componentes adicionados a páginas de conteúdo individuais renderizarão as execuções exatas do fragmento de experiência configurado no componente.
  • Para obter um exemplo de como os recursos de localização do Componente de fragmento de experiência funcionam, consulte a seção abaixo .
  • Para ver um exemplo de como os recursos de localização dos Componentes principais trabalham juntos, consulte a página Recursos de localização dos componentes principais.

Exemplo

Digamos que seu conteúdo se parece com isso:
/content +-- experience-fragments \-- we-retail +-- language-masters +-- us +-- en +-- footerTextXf \-- headerTextXf \-- es +-- footerTextXf \-- headerTextXf \-- ch +-- de +-- footerTextXf \-- headerTextXf +-- fr +-- footerTextXf \-- headerTextXf \-- it +-- footerTextXf \-- headerTextXf +-- we-retail +-- language-masters +-- us +-- en \-- es +-- ch +-- de +-- fr \-- it +-- wknd-events \-- wknd-shop
Observe que a estrutura abaixo
/content/experience-fragments/we-retail
reflete a estrutura de
/content/we-retail
.
Nesse caso, se o componente Fragmento de experiência
/content/experience-fragments/we-retail/us/en/footerTextXf
for colocado em um modelo, as páginas localizadas criadas com base nesse modelo renderizarão automaticamente o fragmento de experiência localizado que corresponde à página de conteúdo localizada.
Portanto, se você navegar até uma página de conteúdo em
/content/we-retail/ch/de
que usa o mesmo modelo,
/content/experience-fragments/we-retail/ch/de/footerTextXf
será renderizado em vez de
/content/experience-fragments/we-retail/us/en/footerTextXf
.

Fallback

O Componente do fragmento de experiência tentará encontrar um componente localizado correspondente na seguinte ordem.
  1. Primeiro ele tenta encontrar uma raiz de idioma.
  2. Se não for encontrada, tenta encontrar um projeto.
  3. Se não for encontrada, ele tenta encontrar uma cópia online.
  4. Se não for encontrado, o padrão será o fragmento de experiência configurado no componente.

Versão e compatibilidade

A versão atual do Componente do fragmento de experiência é a v1, que foi introduzida com a versão 2.6.0 dos Componentes principais em setembro de 2019, e é 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 de versões anteriores.
Versão do componente
AEM 6.3
AEM 6.4
AEM 6.5
v1
Compatível
Compatível
Compatível
Para obter mais informações sobre versões e versões dos Componentes principais, consulte o documento Versões dos componentes principais.

Exemplo de saída de componente

Para experimentar o Componente do fragmento de experiência, bem como ver exemplos de suas opções de configuração, bem como a saída HTML e JSON, visite a Biblioteca de componentes.

Detalhes técnicos

A documentação técnica mais recente sobre o Componente do fragmento de experiência pode ser encontrada no GitHub .
Para obter mais detalhes sobre o desenvolvimento dos Componentes principais, consulte a documentação do desenvolvedor dos Componentes principais.

Configurar caixa de diálogo

A caixa de diálogo de configuração permite que o autor do conteúdo selecione a variação do fragmento da experiência que deve ser renderizada na página.
Use o botão
Abrir caixa de diálogo
de seleção para abrir o seletor de componentes e escolher qual variação de componente de fragmento de experiência adicionar à página de conteúdo.
Se você adicionar o Componente de fragmento de experiência a um modelo, observe que ele será automaticamente localizado desde que os Fragmentos de experiência estejam localizados, de modo que o que é renderizado na página possa variar do componente que você selecionou explicitamente. Consulte o exemplo acima para obter mais informações.

Caixa de diálogo Design

A caixa de diálogo de design permite que o autor do modelo defina as opções disponíveis para o autor do conteúdo que usa o Componente do fragmento de experiência e os padrões definidos ao colocar o Componente do fragmento de experiência.
O componente de fragmento de experiência suporta o AEM Style System .