Componentes para fragmentos de contenido

Última actualización: 2024-01-08

Componentes para la creación de fragmentos

PRECAUCIÓN

No se recomienda ampliar ni cambiar los componentes reales utilizados en el editor de fragmentos, ya que siguen estando sujetos a cambios.

Consulte la API de administración de fragmentos de contenido: del lado del cliente.

Componentes para la creación de páginas

PRECAUCIÓN

El Componente principal de fragmento de contenido ahora se recomienda. Consulte Desarrollo de componentes principales para obtener más información.

Esta sección detalla el componente original entregado para su uso con fragmentos de contenido (Fragmento de contenido en el General grupo).

NOTA

Consulte también Fragmentos de contenido Configurar componentes para procesamiento para obtener más información.

Los fragmentos de contenido de Adobe Experience Manager AEM () son se crean y administran como recursos independientes de la página. Permiten crear contenido neutro con respecto al canal, así como variaciones (posiblemente específicas del canal). A continuación, puede utilizar estos fragmentos, y sus variaciones, al crear páginas de contenido. También puede utilizar un recurso de fragmento de contenido existente de la siguiente manera arrastrándolo desde el explorador de recursos a la página (al igual que para otros componentes basados en recursos, como el componente de base Imagen). El componente de fragmento de contenido predeterminado solo muestra uno elemento del fragmento de contenido al que se hace referencia. Con el cuadro de diálogo de componentes puede definir la variable elemento, variación y rango de párrafos del fragmento que desee mostrar en la página.

NOTA

AEM Este componente Fragmento de contenido se introdujo en la versión 6.2 de como una versión mejorada del componente Artículo, que ha quedado obsoleto.

NOTA

Los fragmentos de contenido no son compatibles con la IU clásica.

Definición

El Fragmento de contenido se utiliza para contener una referencia a un recurso de fragmento de contenido (recursos de texto mejorados de forma efectiva). El tipo de recurso para el fragmento de contenido es el siguiente:

dam/cfm/components/contentfragment/contentfragment

La referencia se define en la propiedad:

fileReference

Solo el editor de la IU táctil admite completamente los componentes de fragmento de contenido, que incluyen la biblioteca de cliente:

cq.authoring.editor.plugin.cfm

Esta biblioteca agrega funciones, específicas de los fragmentos de contenido, al editor. Por ejemplo, está disponible la compatibilidad con la capacidad de agregar y configurar fragmentos de contenido en la página, la capacidad de buscar recursos de fragmentos de contenido en el explorador de recursos y contenido asociado en el panel lateral.

Contenido intermedio

El Fragmento de contenido El componente t permite soltar componentes adicionales entre los distintos párrafos del contenido mostrado elemento. Básicamente, el elemento mostrado está compuesto por diferentes párrafos (cada párrafo está marcado por un retorno de carro). Entre cada uno de esos párrafos, puede insertar contenido mediante otros componentes.

Desde un punto de vista técnico, cada párrafo del elemento mostrado reside en su propio parsys y cada componente que se añade entre los párrafos se inserta (bajo el capó) en el parsys.

En otras palabras, si la instancia del componente de fragmento de contenido está compuesta por tres párrafos, el componente tiene tres parsys diferentes en el repositorio. Todo el contenido intermedio que se añade al fragmento de contenido se encuentra realmente dentro de estos parsys.

En el repositorio, el contenido intermedio se almacena en relación con su posición dentro de la estructura general del párrafo, es decir, no se adjunta al contenido real del párrafo.

Para ilustrar esto, tenga en cuenta lo siguiente:

  • Instancia de un fragmento de contenido compuesto por tres párrafos

  • Y que parte del contenido ya se ha insertado después del segundo párrafo

    • Esto significa que el contenido se almacena en el segundo parsys.

Básicamente, si la estructura de párrafos de esta instancia cambia (al cambiar la variación, el elemento o el intervalo de párrafos mostrados), podría afectar al contenido intermedio que se muestra cuando se reproduce el contenido del fragmento de contenido:

  • Se edita y se añade otro párrafo antes del segundo párrafo:

    • El contenido intermedio se muestra después del párrafo recién creado (el segundo parsys ahora contiene el párrafo recién creado).
  • Se edita y se elimina el segundo párrafo:

    • El contenido intermedio se muestra después del párrafo que antes era el tercero (el segundo parsys ahora contiene el tercer párrafo anterior).
  • Está configurado para que solo se muestre el primer párrafo:

    • No se muestra el contenido intermedio (el segundo parsys ya no se procesa debido a la nueva configuración).

Personalización del componente Fragmento de contenido

Para utilizar el componente de fragmento de contenido listo para usar como modelo para la extensión, debe respetar el siguiente contrato:

  • Reutilice el script de procesamiento HTL y su POJO asociado para poder ver cómo se implementa la función de contenido intermedio.

  • Reutilice el nodo de fragmento de contenido: cq:editConfig

    • El afterinsert/ afteredit/ afterdelete los oyentes se utilizan para almacenar en déclencheur eventos JS. Estos eventos se gestionan en el cq.authoring.editor.plugin.cfm la biblioteca de cliente para mostrar el contenido asociado en el panel lateral.
    • El cq:dropTargets están configuradas para admitir el arrastre de recursos de fragmento de contenido.
    • cq:inplaceEditing está configurado para admitir la creación de un fragmento de contenido en el editor de páginas. El editor in situ de fragmentos se define en la variable cq.authoring.editor.plugin.cfm y permite abrir el archivo actual con un enlace rápido. elemento/variación en el editor de fragmentos.

Reescritura de recursos antes del procesamiento

La administración de fragmentos de contenido utiliza un proceso de renderización interna para generar la salida final del HTML para una página. Esto lo utiliza internamente el componente Fragmento de contenido, pero también el proceso en segundo plano que actualiza los fragmentos a los que se hace referencia en las páginas que hacen referencia.

Internamente, la reescritura de Sling se utiliza para esa renderización. La configuración correspondiente se encuentra en /libs/dam/config/rewriter/cfm y se pueden ajustar, si es necesario. Consulte la Reescritor de Apache Sling para obtener más información.

PRECAUCIÓN

Si ajusta/superpone la configuración de la reescritura:

  • /libs/dam/config/rewriter/cfm

A continuación, el serializerType debe se actualizará a:

  • serializerType="html5-serializer"

La configuración predeterminada utiliza los siguientes transformadores:

  • transformer-cfm-payloadfilter - para recuperar el body parte ( <body>...</body>) solo del HTML del fragmento

  • transformer-cfm-parfilter : elimina los párrafos no deseados si se especifica un intervalo de párrafos (como se puede hacer con el componente Fragmento de contenido)

  • transformer-cfm-assetprocessor : se utiliza internamente para recuperar una lista de los recursos incrustados en el fragmento

El proceso de renderización se expone mediante com.adobe.cq.dam.cfm.content.FragmentRenderService y se pueden utilizar (por ejemplo) mediante componentes personalizados, si es necesario.

En esta página