Experience Fragment Component (v1) experience-fragment-component

Met de Core Component Experience Fragment Component kan de auteur van de inhoud een ervaringsfragmentvariatie op een pagina plaatsen en een gelokaliseerde sitestructuur ondersteunen.

Gebruik usage

Met de Core Component Experience Fragment Component kan de auteur van de inhoud uit bestaande ervaringsfragmentvariaties selecteren en er een op de inhoudspagina plaatsen. De component Experience Fragment ondersteunt ook een gelokaliseerde sitestructuur.

  • De eigenschappen van de component kunnen worden gedefinieerd in het dialoogvenster dialoogvenster configureren.
  • De standaardwaarden voor de component wanneer deze aan een pagina wordt toegevoegd, kunnen worden gedefinieerd in het dialoogvenster ontwerpdialoogvenster.

Versie en compatibiliteit version-and-compatibility

In dit document wordt versie 1 van de Experience Fragment Component beschreven, die in september 2019 werd geïntroduceerd met release 2.6.0 van de Core Components.

CAUTION
In dit document wordt versie 1 van de Experience Fragment-component beschreven.
Zie voor meer informatie over de huidige versie van de Experience Fragment Component Experience Fragment document.

Ondersteuning voor gelokaliseerde sitestructuur localized-site-structure

De Experience Fragment Component is adaptief aan gelokaliseerde sitestructuren en geeft het juiste ervaringsfragment weer op basis van de lokalisatie van de pagina. Hiervoor moet het ervaringsfragment aan de volgende voorwaarden voldoen.

  • De component Experience Fragment wordt toegevoegd aan een sjabloon.
  • Die sjabloon wordt gebruikt om een nieuwe inhoudspagina te maken die deel uitmaakt van een onderstaande gelokaliseerde structuur /content/<site>.
  • Het ervaringsfragment waarnaar op een inhoudspagina wordt verwezen, maakt deel uit van een onderstaande gelokaliseerde ervaringsfragmentstructuur /content/experience-fragments die dezelfde patronen volgt als de onderstaande site /content/<site> inclusief het gebruik van dezelfde componentnamen.

In dit geval wordt het fragment met dezelfde lokalisatie (taal, blauwdruk of live kopie) als de huidige pagina weergegeven als onderdeel van de sjabloon.

Dit gedrag is beperkt tot Geniet van fragmentcomponenten die aan sjablonen zijn toegevoegd. De Componenten van het Fragment van de ervaring die aan individuele inhoudspagina's worden toegevoegd zullen de nauwkeurige vertoningen van het ervaringsfragment teruggeven die binnen de component worden gevormd.

Voorbeeld example

Laten we zeggen dat uw inhoud er ongeveer als volgt uitziet:

/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

U ziet dat de onderstaande structuur /content/experience-fragments/wknd spiegelt de structuur van /content/wknd.

In dit geval, als de component van het Fragment van de Ervaring /content/experience-fragments/wknd/us/en/footerTextXf op een sjabloon wordt geplaatst, geven de gelokaliseerde pagina's die op basis van die sjabloon worden gemaakt automatisch het gelokaliseerde ervaringsfragment weer dat overeenkomt met de gelokaliseerde inhoudspagina.

Dus als u naar een inhoudspagina onder navigeert /content/wknd/ch/de die dezelfde sjabloon gebruiken, /content/experience-fragments/wknd/ch/de/footerTextXf wordt weergegeven in plaats van /content/experience-fragments/wknd/us/en/footerTextXf.

Fallback fallback

De component van het Fragment van de Ervaring zal proberen om een overeenkomstige gelokaliseerde component in de volgende orde te vinden.

  1. Eerst wordt geprobeerd een taalhoofdmap te vinden.
  2. Als deze niet wordt gevonden, wordt geprobeerd een blauwdruk te vinden.
  3. Als deze niet wordt gevonden, wordt geprobeerd een live kopie te zoeken.
  4. Als deze optie niet wordt gevonden, wordt standaard het ervaringsfragment weergegeven dat in de component is geconfigureerd.

Uitvoer van voorbeeldcomponent sample-component-output

Als u de Experience Fragment-component wilt ervaren en voorbeelden wilt zien van zijn configuratieopties en HTML- en JSON-uitvoer, gaat u naar de Componentbibliotheek.

Technische details technical-details

De meest recente technische documentatie over de component Experience Fragment kan op GitHub worden gevonden.

Meer informatie over het ontwikkelen van kerncomponenten vindt u in de Documentatie voor ontwikkelaars van kerncomponenten.

Dialoogvenster configureren configure-dialog

In het dialoogvenster Configureren kan de auteur van de inhoud de variatie van het ervaringsfragment selecteren die op de pagina moet worden weergegeven.

Het bewerkingsdialoogvenster van de fragmentcomponent beleven

Gebruik de Dialoogvenster Selectie openen om de componentkiezer te openen en te kiezen welke fragmentcomponentvariatie u aan de inhoudspagina wilt toevoegen.

Als u de Component van het Fragment van de Ervaring aan een malplaatje toevoegt, merk op dat het automatisch zal worden gelokaliseerd op voorwaarde dat de Fragmenten van de Ervaring worden gelokaliseerd, zodat wat op de pagina wordt teruggegeven van de component kan variëren u uitdrukkelijk selecteert. Zie het bovenstaande voorbeeld voor meer informatie .

U kunt ook een ID. Met deze optie kunt u de unieke id van de component in de HTML en in de Gegevenslaag.

  • Als deze leeg blijft, wordt automatisch een unieke id voor u gegenereerd. U kunt deze vinden door de resulterende pagina te inspecteren.
  • Als een id is opgegeven, is het de verantwoordelijkheid van de auteur om ervoor te zorgen dat deze uniek is.
  • Het wijzigen van de id kan gevolgen hebben voor het bijhouden van CSS-, JS- en gegevenslagen.

Ontwerpdialoogvenster design-dialog

In het dialoogvenster Ontwerpen kan de sjabloonauteur de opties definiëren die beschikbaar zijn voor de auteur van de inhoud die de component Experience Fragment gebruikt en de standaardinstellingen die zijn ingesteld bij het plaatsen van de Experience Fragment-component.

Tabblad Stijlen styles-tab

De ervaringsfragmentcomponent ondersteunt de AEM Stijlsysteem.

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c