DocumentazioneAEM 6.4Guida allo sviluppo

Componenti per frammenti di contenuto components-for-content-fragments

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Developer
CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.
CAUTION
Alcune funzionalità dei frammenti di contenuto richiedono l’applicazione di AEM 6.4 Service Pack 2 (6.4.2.0).

Componenti per l’authoring dei frammenti components-for-fragment-authoring

CAUTION
Non è consigliabile estendere o modificare i componenti effettivi utilizzati nell’Editor frammento in quanto sono ancora soggetti a modifiche.

Consulta la sezione API di gestione dei frammenti di contenuto - Lato client.

Componenti per l’authoring delle pagine components-for-page-authoring

CAUTION
La Componente core frammento di contenuto è ora consigliato. Vedi Sviluppo di componenti core per ulteriori dettagli.
Questa sezione descrive il componente originale consegnato per l’uso con i frammenti di contenuto (Frammento di contenuto in Generale gruppo).

I frammenti di contenuto di Adobe Experience Manager (AEM) vengono creati e gestiti come risorse indipendenti dalla pagina. Consentono di creare contenuti neutri per il canale, insieme a varianti (eventualmente specifiche per il canale). Puoi quindi utilizzare questi frammenti, con le relative varianti, durante l’authoring di pagine di contenuto. Puoi inoltre utilizzare una risorsa frammento di contenuto esistente per trascinarlo dal browser delle risorse alla pagina (come per altri componenti basati su risorse, ad esempio il componente di base Immagine). Il componente per frammenti di contenuto pronto all’uso visualizza un solo componente elemento del frammento di contenuto a cui si fa riferimento. Nella finestra di dialogo del componente puoi definire la elemento, variante e intervallo di paragrafi del frammento che si desidera visualizzare sulla pagina.

NOTE
Questo componente Frammento di contenuto è stato introdotto in AEM 6.2 come versione avanzata del componente Articolo , che è stato dichiarato obsoleto.
NOTE
I frammenti di contenuto non sono supportati nell’interfaccia classica.

Definizione definition

La Frammento di contenuto viene utilizzato per contenere un riferimento a una risorsa di frammento di contenuto (con miglioramenti effettivi delle risorse di testo). Il tipo di risorsa per il frammento di contenuto è:

  • dam/cfm/components/contentfragment/contentfragment

Il riferimento è definito nella proprietà :

  • fileReference

Solo l’editor dell’interfaccia touch supporta completamente i componenti dei frammenti di contenuto, che includono la libreria client:

  • cq.authoring.editor.plugin.cfm

Questa libreria aggiunge all’editor funzioni specifiche dei frammenti di contenuto. Ad esempio, sono disponibili il supporto per la possibilità di aggiungere e configurare frammenti di contenuto nella pagina, la possibilità di cercare risorse per frammenti di contenuto nel browser Risorse e per il contenuto associato nel pannello laterale.

Contenuto intermedio in-between-content

La Frammenti di contenuto Il componente permette di rilasciare ulteriori componenti tra i diversi paragrafi della elemento. In sostanza, l’elemento visualizzato è composto da paragrafi diversi (ogni paragrafo è contrassegnato da un ritorno a capo). Tra ciascuno di questi paragrafi, puoi inserire il contenuto utilizzando altri componenti.

Da un punto di vista tecnico, ogni paragrafo dell’elemento visualizzato vive nel proprio parsys e ogni componente aggiunto tra i paragrafi sarà inserito (sotto il cofano) nel parsys.

In altre parole, se l’istanza del componente frammento di contenuto è composta da tre paragrafi, il componente avrà tre parsys diversi nell’archivio. Tutto il contenuto intermedio aggiunto al frammento di contenuto si trova effettivamente all’interno di questi parsys.

Nell’archivio il contenuto intermedio viene memorizzato rispetto alla sua posizione all’interno della struttura del paragrafo generale, ovvero non è collegato al contenuto effettivo del paragrafo.

A questo proposito, consideriamo che:

  • Un’istanza di un frammento di contenuto composto da tre paragrafi

  • E che alcuni contenuti sono già stati inseriti dopo il secondo paragrafo

    • Ciò significa che il contenuto verrà memorizzato nel secondo parsys.

In sostanza, se la struttura del paragrafo di questa istanza cambia (modificando la variante, l’elemento o l’intervallo di paragrafi visualizzati), potrebbe influenzare il contenuto intermedio visualizzato quando il contenuto del frammento di contenuto:

  • Viene modificato e viene aggiunto un altro paragrafo prima del secondo paragrafo:

    • Il contenuto intermedio verrà visualizzato dopo il nuovo paragrafo creato (il secondo parsys ora contiene il paragrafo appena creato).

  • Viene modificato e il secondo paragrafo viene rimosso:

    • Il contenuto intermedio viene visualizzato dopo il paragrafo precedente (il secondo parsys ora contiene il terzo paragrafo precedente).

  • È configurato in modo che venga visualizzato solo il primo paragrafo:

    • Il contenuto intermedio non verrà visualizzato (il secondo parsys non viene più visualizzato a causa della nuova configurazione).

Personalizzazione del componente Frammento di contenuto customizing-the-content-fragment-component

Per utilizzare il componente frammento di contenuto predefinito come blueprint per l’estensione, è necessario rispettare il contratto seguente:

  • Riutilizza lo script di rendering HTL e il relativo POJO associato per vedere come viene implementata la funzione di contenuto intermedio.

  • Riutilizzare il nodo del frammento di contenuto: cq:editConfig

    • La afterinsert/ afteredit/ afterdelete i listener vengono utilizzati per attivare gli eventi JS. Questi eventi verranno gestiti nel cq.authoring.editor.plugin.cfm libreria client per visualizzare il contenuto associato nel pannello laterale.
    • La cq:dropTargets sono configurati per supportare il trascinamento delle risorse dei frammenti di contenuto.
    • cq:inplaceEditing è configurato per supportare la creazione di un frammento di contenuto nell’editor pagina. L’editor locale del frammento è definito nella sezione cq.authoring.editor.plugin.cfm libreria client e consente un collegamento rapido per aprire la elemento/variante in editor frammenti.

Riscrittura delle risorse prima del rendering asset-rewriting-before-rendering

La gestione dei frammenti di contenuto utilizza un processo di rendering interno per generare l’output finale di HTML per una pagina. Viene utilizzato internamente dal componente Frammento di contenuto, ma anche dal processo in background che aggiorna i frammenti di riferimento sulle pagine di riferimento.

Internamente, lo sling Rewriter viene utilizzato per quel rendering. La configurazione corrispondente si trova in /libs/dam/config/rewriter/cfm e può essere regolato se necessario. Consulta la sezione Rewriter Sling Apache per ulteriori informazioni.

La configurazione predefinita utilizza i seguenti trasformatori:

  • transformer-cfm-payloadfilter - per il recupero del body parte ( <body>...</body>) solo del HTML del frammento

  • transformer-cfm-parfilter - filtra i paragrafi indesiderati se è specificato un intervallo di paragrafi (come è possibile fare con il componente Frammento di contenuto)

  • transformer-cfm-assetprocessor - viene utilizzato internamente per recuperare un elenco delle risorse incorporate nel frammento

Il processo di rendering viene esposto attraverso [com.adobe.cq.dam.cfm.content.FragmentRenderService](https://helpx.adobe.com/experience-manager/6-4/sites/developing/using/reference-materials/javadoc/com/adobe/cq/dam/cfm/ContentFragment.html) e può essere utilizzato (ad esempio) dai componenti personalizzati, se necessario.

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e