Show Menu
TOPICS×

Experience Fragment Component

The Core Component Experience Fragment Component allows the content author to place an experience fragment variation on a page while supporting a localized site structure.

Utilizzo

The Core Component Experience Fragment Component allows the content author to select from existing experience fragment varations and place one on the content page. The Experience Fragment component also supports a localized site structure.
  • Le proprietà dei componenti possono essere definite nella finestra di dialogo di configurazione.
  • Defaults for the component when adding it to a page can be defined in the design dialog. Design Dialog

Supporto struttura sito localizzata

Il componente Frammento esperienza si adatta alle strutture del sito localizzate ed esegue il rendering del frammento esperienza appropriato in base alla localizzazione della pagina. A tal fine, il frammento di esperienza deve soddisfare le seguenti condizioni.
  • Il componente Frammento esperienza viene aggiunto a un modello.
  • Tale modello viene utilizzato per creare una nuova pagina di contenuto che fa parte di una struttura localizzata di seguito
    /content/<site>
    .
  • Il frammento esperienza a cui si fa riferimento in una pagina di contenuto fa parte di una struttura di frammento esperienza localizzata sotto
    /content/experience-fragments
    che segue gli stessi pattern del sito sottostante,
    /content/<site>
    compreso l'utilizzo degli stessi nomi di componente.
In questo caso, il frammento con la stessa localizzazione (lingua, blueprint o Live Copy) della pagina corrente verrà rappresentato come parte del modello.
Questo comportamento è limitato ai componenti frammento esperienza aggiunti ai modelli. Frammenti esperienza I componenti aggiunti alle singole pagine di contenuto renderanno effettive le rappresentazioni dei frammenti esperienza configurate all’interno del componente.
  • Per un esempio del funzionamento delle funzioni di localizzazione del componente Frammento esperienza, consultate la sezione seguente .
  • Per un esempio di come le funzioni di localizzazione dei componenti core funzionano insieme, consultate le funzioni di localizzazione della pagina Componenti principali.

Esempio

Supponiamo che il contenuto sia simile al seguente:
/content +-- experience-fragments \-- we-retail +-- language-masters +-- us +-- en +-- footerTextXf \-- headerTextXf \-- es +-- footerTextXf \-- headerTextXf \-- ch +-- de +-- footerTextXf \-- headerTextXf +-- fr +-- footerTextXf \-- headerTextXf \-- it +-- footerTextXf \-- headerTextXf +-- we-retail +-- language-masters +-- us +-- en \-- es +-- ch +-- de +-- fr \-- it +-- wknd-events \-- wknd-shop
Notate che la struttura sottostante
/content/experience-fragments/we-retail
rispecchia la struttura di
/content/we-retail
.
In questo caso, se il componente Frammento esperienza
/content/experience-fragments/we-retail/us/en/footerTextXf
viene inserito in un modello, le pagine localizzate create in base a tale modello eseguiranno automaticamente il rendering del frammento esperienza localizzato che corrisponde alla pagina di contenuto localizzata.
Pertanto, se andate a una pagina di contenuto sotto
/content/we-retail/ch/de
che utilizza lo stesso modello,
/content/experience-fragments/we-retail/ch/de/footerTextXf
verrà eseguito il rendering invece di
/content/experience-fragments/we-retail/us/en/footerTextXf
.

Fallback

Il componente Frammento esperienza tenta di trovare un componente localizzato corrispondente nell’ordine seguente.
  1. Per prima cosa cerca di trovare una radice della lingua.
  2. Se non viene trovato, tenta di trovare un modello.
  3. Se non viene trovata, cerca di trovare una Live Copy.
  4. Se non viene trovata, per impostazione predefinita viene utilizzato il frammento esperienza configurato nel componente.

Versione e compatibilità

La versione corrente del componente Frammento esperienza è v1, introdotto con la release 2.6.0 dei componenti core a settembre 2019, ed è descritto in questo documento.
La tabella seguente elenca tutte le versioni supportate del componente, le versioni AEM con cui sono compatibili le versioni del componente e i collegamenti alla documentazione delle versioni precedenti.
Versione componente
AEM 6.3
AEM 6.4
AEM 6.5
v1
Compatibile
Compatibile
Compatibile
Per ulteriori informazioni sulle versioni e sulle versioni dei componenti core, consulta il documento Versioni dei componenti core.

Output componente di esempio

Per provare il componente Frammento esperienza e per vedere esempi delle relative opzioni di configurazione, nonché l’output HTML e JSON, visita la Libreria experience-fragment.html componenti.

Technical Details

The latest technical documentation about the Experience Fragment Component can be found on GitHub. experience-fragment
Further details about developing Core Components can be found in the Core Components developer documentation. Sviluppo di componenti core

Configure Dialog

The configure dialog allows the content author to select the experience fragment variation that should be rendered on the page.
Use the Open Selection Dialog button to open the component selector to choose which experience fragment component variation to add to the content page.
If you add the Experience Fragment Component to a template, note that it will be automatically localized provided that the Experience Fragments are localized, so what is rendered on the page may vary from the component you explicitly select. See the example above for more information.

Design Dialog

The design dialog allows the template author to define the options available to the content author who uses the Experience Fragment Component and the defaults set when placing the Experience Fragment Component.
The Experience Fragment Component supports the AEM Style System. Attribuzione stile componente