Componente de Fragmento de experiência (v1)

Última atualização em 2023-05-20
  • Criado para:
  • Developer
    Admin
    User

O componente de Fragmento de experiência, dos Componentes principais, permite que o autor de conteúdo coloque uma variação de fragmento de experiência em uma página enquanto suporta uma estrutura de site localizada.

Uso

O componente de Fragmento de experiência, dos Componentes principais, permite que o autor de conteúdo selecione uma das variações de fragmento de experiência existentes e coloque uma na página de conteúdo. O componente Fragmento de experiência também suporta uma estrutura de site localizada.

Versão e compatibilidade

Este documento descreve a versão v1 do componente de fragmento de experiência, que foi introduzida com a versão 2.6.0 dos componentes principais em setembro de 2019.

ATENÇÃO

Este documento descreve a versão v1 do componente de fragmento de experiência.

Para obter detalhes sobre a versão atual do componente de fragmento de experiência, consulte o documento Componente de fragmento de experiência.

Suporte localizado à estrutura do site

O componente de 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 de 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 de /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 /content/experience-fragments que segue os mesmos padrões do site abaixo de /content/<site>, incluindo o uso dos mesmos nomes de componente.

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 de Fragmento de experiência adicionados aos modelos. Os componentes de Fragmento de experiência adicionados a páginas de conteúdo individuais renderizarão as representações exatas do fragmento de experiência configuradas no componente.

Exemplo

Digamos que seu conteúdo seja mais ou menos assim:

/content
+-- experience-fragments
   \-- wknd
      +-- language-masters
      +-- us
         +-- en
            +-- footerTextXf
            \-- headerTextXf
         \-- es
            +-- footerTextXf
            \-- headerTextXf
      \-- ch
         +-- de
            +-- footerTextXf
            \-- headerTextXf
         +-- fr
            +-- footerTextXf
            \-- headerTextXf
         \-- it
            +-- footerTextXf
            \-- headerTextXf
+-- wknd
   +-- language-masters
   +-- us
      +-- en
      \-- es
   +-- ch
      +-- de
      +-- fr
      \-- it
+-- wknd-events
\-- wknd-shop

Observe que a estrutura abaixo /content/experience-fragments/wknd reflete a estrutura de /content/wknd.

Nesse caso, se o componente de Fragmento de experiência /content/experience-fragments/wknd/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 para uma página de conteúdo em /content/wknd/ch/de que usa o mesmo modelo, /content/experience-fragments/wknd/ch/de/footerTextXf será renderizado, em vez de /content/experience-fragments/wknd/us/en/footerTextXf.

Fallback

O componente de 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, ele tentará encontrar um blueprint.
  3. Se não for encontrado, ela tentará encontrar uma live copy.
  4. Se não for encontrada, o padrão será o fragmento de experiência configurado no componente.

Exemplo de saída do componente

Para experimentar o componente Fragmento de Experiência, 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 de Fragmento de experiência 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 selecione a variação de fragmento de experiência que deve ser renderizada na página.

Caixa de diálogo de edição do componente de Fragmento de experiência

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á localizado automaticamente, desde que os Fragmentos de experiência estejam localizados, de modo que o que é renderizado na página possa variar do componente selecionado explicitamente. Consulte o exemplo acima para mais informações.

Você também pode definir um 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.

Caixa de diálogo de design

A caixa de diálogo de design permite que o autor do modelo defina as opções disponíveis para o autor de conteúdo que usa o componente de Fragmento de experiência e os padrões definidos ao instalar o componente.

Guia Estilos

O componente Fragmento de experiência é compatível com o Sistema de Estilos do AEM.

Nesta página