Componente Frammento esperienza experience-fragment-component

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.

Utilizzo usage

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.

Versione e compatibilità version-and-compatibility

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 as a Cloud Service
v2
-
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 localized-site-structure

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.

Esempio example

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 fallback

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

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

Esempio di output del componente sample-component-output

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 technical-details

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 configure-dialog

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 Data Layer.

  • 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 Data Layer.

Scheda Stili styles-tab-edit

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 design-dialog

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 styles-tab

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

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