Experience Fragment 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 in worden bepaald vormen dialoog.
- De gebreken voor de component wanneer het toevoegen van het aan een pagina kunnen in de ontwerpdialoogworden bepaald.
Versie en compatibiliteit version-and-compatibility
De huidige versie van de Experience Fragment Component is v2, die in februari 2022 werd geïntroduceerd met release 2.18.0 van de Core Components, en die in dit document wordt beschreven.
In de volgende tabel staan alle ondersteunde versies van de component, de AEM versies waarmee de versies van de component compatibel zijn en koppelingen naar documentatie voor vorige versies.
Voor meer informatie over de versies en versies van de Component van de Kern, zie de Versies van de Componenten van de Document Kern.
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 gelokaliseerde structuur onder
/content/<site>
. - Het ervaringsfragment waarnaar op een inhoudspagina wordt verwezen, maakt deel uit van een gelokaliseerde ervaringsfragmentstructuur onder
/content/experience-fragments
die dezelfde patronen volgt als de site onder/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.
- Voor een voorbeeld van hoe de localisatieeigenschappen van de Component van het Fragment van de Ervaring werken, zie de sectie hieronder.
- Voor een voorbeeld van hoe de localisatieeigenschappen van de Componenten van de Kern samenwerken, zie de Eigenschappen van de Localisatie van de pagina van de Componenten van de Kern.
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
De structuur onder /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 malplaatje wordt geplaatst, zullen de gelokaliseerde pagina's die op dat malplaatje worden gecreeerd automatisch het gelokaliseerde ervaringsfragment teruggeven dat aan de gelokaliseerde inhoudspagina beantwoordt.
Als u dus naar een inhoudspagina navigeert onder /content/wknd/ch/de
die dezelfde sjabloon gebruikt, wordt /content/experience-fragments/wknd/ch/de/footerTextXf
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.
- Eerst wordt geprobeerd een taalhoofdmap te vinden.
- Als deze niet wordt gevonden, wordt geprobeerd een blauwdruk te vinden.
- Als deze niet wordt gevonden, wordt geprobeerd een live kopie te zoeken.
- Als deze optie niet wordt gevonden, wordt standaard het ervaringsfragment weergegeven dat in de component is geconfigureerd.
Uitvoer van voorbeeldcomponent sample-component-output
Om de Component van het Fragment van de Ervaring te ervaren evenals voorbeelden van zijn configuratieopties evenals HTML en output JSON, bezoek de Bibliotheek van de Component.
Technische details technical-details
De recentste technische documentatie over de Component van het Fragment van de Ervaring kan op GitHubworden gevonden.
De verdere details over het ontwikkelen van de Componenten van de Kern kunnen in de de ontwikkelaarsdocumentatie van de Componenten van de Kern worden gevonden.
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.
Gebruik de Open knoop van de Dialoog van de Selectie om de componentenselecteur te openen om te kiezen welke de variatie van de fragmentcomponent om aan de inhoudspagina toe te voegen ervaart.
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 voorbeeld hierbovenvoor meer informatie.
U kunt ook een identiteitskaart bepalen. Deze optie staat toe om het unieke herkenningsteken van de component in de HTML en in de Laag van Gegevenste controleren.
- 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.
Tabblad Stijlen styles-tab-edit
De Component van het Fragment van de Ervaring steunt het AEM Systeem van de Stijl..
Gebruik de vervolgkeuzelijst om de stijlen te selecteren die u op de component wilt toepassen. Selecties in het dialoogvenster Bewerken hebben hetzelfde effect als de selecties op de werkbalk van de component.
De stijlen moeten voor deze component in de ontwerpdialoogworden gevormd opdat het drop-down menu beschikbaar is.
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 Component van het Fragment van de Ervaring steunt het AEM Systeem van de Stijl.