Experience Fragment Component (v1)

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

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.

• Komponentens egenskaper kan definieras i konfigurera dialogruta.
• Standardvärden för komponenten när du lägger till den på en sida kan definieras i designdialogruta.

Version och kompatibilitet

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

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.

• Experience Fragment-komponenten läggs till i en mall.
• Den mallen används för att skapa en ny innehållssida som är en del av en lokaliserad struktur nedan /content/<site>.
• Det upplevelsefragment som refereras på en innehållssida är en del av en lokaliserad upplevelsefragmentstruktur nedan /content/experience-fragments som följer samma mönster som webbplatsen nedan /content/<site> och använda samma komponentnamn.

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.

• Ett exempel på hur lokaliseringsfunktionerna i Experience Fragment Component fungerar finns i avsnittet nedan.
• Ett exempel på hur lokaliseringsfunktionerna för kärnkomponenterna fungerar tillsammans finns i Lokaliseringsfunktioner för sidan Core Components.

Exempel

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

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

1. Först försöker den hitta en språkrot.
2. Om den inte hittas försöker den hitta en plan.
3. Om den inte hittas försöker den hitta en live-kopia.
4. Om det inte hittas används det Experience fragment som konfigurerats i komponenten som standard.

Exempel på komponentutdata

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

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

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.

• Om inget anges genereras ett unikt ID automatiskt åt dig och du hittar det genom att granska den resulterande sidan.
• Om ett ID anges är det författarens ansvar att se till att det är unikt.
• Om du ändrar ID:t kan det påverka spårningen av CSS, JS och datalager.

Designdialogruta

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

Experience Fragment-komponenten stöder AEM Formatsystem.