Documentazione AEM Guida dei Componenti core

Componente Frammento esperienza

Ultimo aggiornamento: 27 giugno 2025

Argomenti:
Core Components

Creato per:

Sviluppatore
Amministratore
Utente

Il componente Frammento esperienza consente all’autore di contenuto di inserire una variante del Frammento esperienza in una pagina e al contempo di supportare una struttura localizzata del sito.

SUGGERIMENTO

Hai preso in considerazione Edge Delivery Services per AEM?

Puoi continuare a utilizzare i metodi descritti in questo documento per i progetti esistenti. Tuttavia, per i nuovi progetti, Adobe consiglia di sfruttare Edge Delivery Services.

Utilizzo

Il componente Frammento esperienza consente all’autore di contenuto di selezionare tra le varianti di Frammento esperienza esistenti e inserirne una nella pagina di contenuto. Il componente Frammento esperienza supporta anche una struttura localizzata del sito.

Le proprietà del componente possono essere definite nella finestra di dialogo per configurazione.
Le impostazioni predefinite del componente, quando lo si aggiunge a una pagina, possono essere definite nella finestra di dialogo per progettazione.

Versione e compatibilità

La versione corrente del componente Frammento esperienza è la v2, introdotta con la versione 2.18.0 dei Componenti core a febbraio 2022, ed è quella descritta in questo documento.

La tabella che segue descrive tutte le versioni supportate del componente, le versioni di AEM con cui le versioni del componente sono compatibili e i collegamenti alla documentazione delle versioni precedenti.

Versione del componente	AEM 6.4	AEM 6.5	AEM 6.5 LTS	AEM as a Cloud Service
v2	-	Compatibile	Compatibile	Compatibile
v1	Compatibile	Compatibile	-	Compatibile

Per ulteriori informazioni sulle versioni e sugli aggiornamenti dei Componenti core, vedi il documento Versioni dei Componenti core.

Supporto della struttura localizzata del sito

Il componente Frammento esperienza si adatta alle strutture localizzate dei siti ed esegue il rendering del Frammento esperienza appropriato in base alla localizzazione della pagina. A questo scopo, il Frammento esperienza deve soddisfare le seguenti condizioni.

Il componente Frammento esperienza viene aggiunto a un modello.
Il modello viene utilizzato per creare una nuova pagina di contenuto che fa parte di una struttura localizzata sotto /content/<site>.
Il Frammento esperienza a cui si fa riferimento in una pagina di contenuto fa parte di una struttura di Frammenti esperienza localizzati sotto /content/experience-fragments che segue gli stessi modelli del sito sotto /content/<site>, incluso l’utilizzo degli stessi nomi di componenti.

In questo caso, come parte del modello, verrà eseguito il rendering del frammento con la stessa localizzazione (lingua, blueprint o Live Copy) della pagina corrente.

Questo comportamento è limitato ai componenti Frammento esperienza aggiunti ai modelli. I componenti Frammento esperienza aggiunti alle singole pagine di contenuto restituiranno esattamente le rappresentazioni dei Frammenti esperienza configurate all’interno del componente.

Per un esempio delle funzioni di localizzazione del componente Frammento esperienza, vedi la sezione che segue.
Per un esempio dell’interazione delle funzioni di localizzazione dei Componenti core, visita la pagina Funzioni di localizzazione dei Componenti core.

Esempio

Supponiamo che il contenuto sia simile al seguente:

/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

Nota come la struttura sotto /content/experience-fragments/wknd rispecchi la struttura di /content/wknd.

In questo caso, se il componente Frammento esperienza /content/experience-fragments/wknd/us/en/footerTextXf è inserito in un modello, per le pagine localizzate create in base a quel modello verrà automaticamente eseguito il rendering del Frammento esperienza localizzato corrispondente alla pagina localizzata.

Pertanto, se vai a una pagina di contenuto sotto /content/wknd/ch/de che utilizza lo stesso modello, viene eseguito il rendering di /content/experience-fragments/wknd/ch/de/footerTextXf invece di /content/experience-fragments/wknd/us/en/footerTextXf.

Regresso

Il componente Frammento esperienza tenta di trovare un componente localizzato corrispondente nell’ordine seguente.

Prima tenta di trovare una directory principale della lingua.
Se non la trova, tenta di trovare un modello.
Se non lo trova, tenta di trovare una Live Copy.
Se non la trova, per impostazione predefinita viene visualizzato il Frammento esperienza configurato nel componente.

Esempio di output del componente

Per avere un’idea del componente Frammento esperienza e vedere esempi delle opzioni di configurazione e dell’output HTML e JSON, visita la libreria dei componenti.

Dettagli tecnici

La documentazione tecnica più recente sul componente Frammento esperienza è disponibile su GitHub.

Per ulteriori informazioni sullo sviluppo di Componenti core, vedi la documentazione per gli sviluppatori di Componenti core.

Finestra di dialogo per configurazione

La finestra di dialogo per configurazione consente all’autore di contenuto di selezionare la variante del Frammento di esperienza di cui eseguire il rendering sulla pagina.

Finestra di dialogo per modifica del componente Frammento esperienza

Utilizza il pulsante Apri finestra di dialogo per selezione per aprire il selettore di componenti e scegliere la variante del componente Frammento esperienza da aggiungere alla pagina di contenuto.

Se aggiungi il componente Frammento esperienza a un modello, noterai che verrà automaticamente localizzato, a condizione che i Frammenti esperienza siano localizzati, pertanto ciò che viene rappresentato sulla pagina può variare in base al componente esplicitamente selezionato. Per ulteriori informazioni, vedi l’esempio precedente.

Puoi anche definire un ID. Questa opzione consente di controllare l’identificatore univoco del componente nel codice HTML e nel livello dati.

Se non specificato, viene generato automaticamente un ID univoco reperibile sulla pagina risultante.
Se l’ID viene specificato, è responsabilità dell’autore accertarsi che sia univoco.
La modifica dell’ID può avere un impatto sul tracciamento di CSS, JS e livello dati.

Scheda Stili

Scheda Stili della finestra di dialogo di modifica del componente Frammento esperienza

Il componente Frammento esperienza supporta il sistema di stili di AEM.

Utilizza il menu a discesa per selezionare gli stili da applicare al componente. Le selezioni effettuate nella finestra di dialogo di modifica hanno lo stesso effetto di quelle selezionate nella barra degli strumenti del componente.

Gli stili devono essere configurati per questo componente nella finestra di dialogo di progettazione affinché il menu a discesa sia disponibile.

Finestra di dialogo per progettazione

La finestra di dialogo per progettazione consente all’autore del modello di definire le opzioni disponibili per l’autore di contenuto che utilizza il componente Frammento esperienza e le impostazioni predefinite scelte al momento del posizionamento del Frammento esperienza.

Scheda Stili

Il componente Frammento esperienza supporta il sistema di stili di AEM.

recommendation-more-help