Componente de Fragmento de experiência de email email-experience-fragment-component

O Componente de Fragmento de experiência de email permite que o autor de conteúdo coloque uma variação de Fragmento de experiência em seu conteúdo enquanto suporta uma estrutura de conteúdo localizada.

Uso usage

O componente de Fragmento de experiência de email permite que o autor de conteúdo selecione entre as variações de Fragmento de experiência existentes e coloque uma no conteúdo. Um Fragmento de experiência é um grupo de conteúdo que inclui conteúdo e layout e é reutilizável em canais.

O componente de Fragmento de experiência de email suporta uma estrutura de site localizada.

Versão e compatibilidade version-and-compatibility

A versão atual do Componente de Fragmento de experiência de email é a v1, introduzida com a versão X dos Componentes principais de email em outubro de 2022, 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.

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

Suporte localizado à estrutura do site localized-site-structure

O Componente de Fragmento de experiência de email é adaptável às estruturas de conteúdo localizadas e renderiza o Fragmento de experiência adequado com base na localização do conteúdo. Para fazer isso, o Fragmento de experiência deve atender às seguintes condições:

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

Exemplo example

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 de email /content/experience-fragments/wknd/us/en/footerTextXf for colocado em um modelo, as páginas localizadas criadas com base nesse modelo irão renderizar 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 fallback

O Componente de Fragmento de experiência de email vai tentar encontrar um componente localizado correspondente na seguinte ordem.

Detalhes técnicos technical-details

Leia a mais recente documentação técnica sobre o Componente de fragmento de experiência.

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 configure-dialog

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 no conteúdo.

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 de email a um modelo, 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 HTM.

Guia Estilos styles-tab-edit

O Componente do Fragmento de experiência de email é compatível com o Sistema de estilos do AEM.

Use o menu suspenso para selecionar os estilos que deseja aplicar ao componente. As seleções feitas na caixa de diálogo de edição têm o mesmo efeito das selecionadas na barra de ferramentas do componente.

Os estilos devem ser configurados para este componente na caixa de diálogo de design para que a guia fique disponível.

Caixa de diálogo de design design-dialog

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 de email e os padrões definidos ao instalar o componente.

Guia Estilos styles-tab

O Componente Fragmento de experiência de email é compatível com o Sistema de estilos do AEM.