Experience Fragment Component (v1) experience-fragment-component

Med kärnkomponentens Experience Fragment-komponent kan innehållsförfattaren placera en variant av upplevelsefragment på en sida med stöd för en lokaliserad webbplatsstruktur.

Användning usage

Med kärnkomponentens Experience Fragment-komponent kan innehållsförfattaren välja bland befintliga upplevelsefragmentvarianter och placera en på innehållssidan. Experience Fragment-komponenten har också stöd för en lokaliserad platsstruktur.

Version och kompatibilitet version-and-compatibility

I det här dokumentet beskrivs v1 av Experience Fragment Component, som introducerades i version 2.6.0 av Core Components i september 2019.

Lokaliserat stöd för webbplatsstruktur localized-site-structure

Experience Fragment-komponenten är anpassad till lokaliserade webbplatsstrukturer och återger rätt upplevelsefragment baserat på sidans lokalisering. För att göra detta måste upplevelsefragmentet uppfylla följande villkor.

I det här fallet återges fragmentet med samma lokalisering (språk, utkast eller live-kopia) som den aktuella sidan som en del av mallen.

Det här beteendet är begränsat till Experience Fragment Components som lagts till i mallar. Experience Fragment Components som lagts till på enskilda innehållssidor återger de exakta upplevelsefragmentåtergivningarna som konfigurerats i komponenten.

Exempel example

Låt oss säga att innehållet ser ut ungefär så här:

/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

Observera att strukturen nedan /content/experience-fragments/wknd speglar strukturen i /content/wknd.

I det här fallet, om komponenten Experience Fragment /content/experience-fragments/wknd/us/en/footerTextXf placeras i en mall, kommer de lokaliserade sidor som skapas baserat på den mallen automatiskt att återge det lokaliserade upplevelsefragment som motsvarar den lokaliserade innehållssidan.

Så om du navigerar till en innehållssida under /content/wknd/ch/de som använder samma mall, /content/experience-fragments/wknd/ch/de/footerTextXf återges i stället för /content/experience-fragments/wknd/us/en/footerTextXf.

Reserv fallback

Experience Fragment-komponenten kommer att försöka hitta en motsvarande lokaliserad komponent i följande ordning.

Exempel på komponentutdata sample-component-output

Om du vill visa Experience Fragment Component och se exempel på dess konfigurationsalternativ samt HTML och JSON-utdata går du till Komponentbibliotek.

Teknisk information technical-details

Den senaste tekniska dokumentationen om Experience Fragment-komponenten finns på GitHub.

Mer information om hur du utvecklar kärnkomponenter finns i Dokumentation för grundkomponentutvecklare.

Konfigurera dialogruta configure-dialog

I dialogrutan Konfigurera kan innehållsförfattaren välja den variant av upplevelsefragment som ska återges på sidan.

Använd Öppna dialogrutan Markering för att öppna komponentväljaren och välja vilken upplevelsefragmentkomponentvariant som ska läggas till på innehållssidan.

Om du lägger till Experience Fragment-komponenten i en mall bör du tänka på att den automatiskt lokaliseras, förutsatt att Experience Fragments lokaliseras, så att det som återges på sidan kan variera från den komponent som du uttryckligen väljer. Se exemplet ovan för mer information.

Du kan också definiera en ID. Med det här alternativet kan du styra den unika identifieraren för komponenten i HTML och i Datalager.

Designdialogruta design-dialog

I designdialogrutan kan mallskaparen definiera de alternativ som är tillgängliga för den som använder Experience Fragment-komponenten och de standardvärden som anges när Experience Fragment-komponenten monteras.

Fliken Format styles-tab

Experience Fragment-komponenten stöder AEM Formatsystem.