Componente de fragmento de experiencia

El componente de fragmento de experiencia de componente principal permite al autor del contenido colocar una variación de fragmento de experiencia en una página mientras se admite una estructura de sitio localizada.

Uso

El componente de fragmento de experiencia de componente principal permite al autor del contenido seleccionar entre las variaciones de fragmento de experiencia existentes y colocar una en la página de contenido. El componente Fragmento de experiencia también admite una estructura de sitio localizada.

• Las propiedades del componente se pueden definir en el cuadro de diálogo configurar.
• Los valores predeterminados del componente al agregarlo a una página se pueden definir en el cuadro de diálogo diseño.

Compatibilidad con la estructura del sitio localizada

El componente Fragmento de experiencia se adapta a las estructuras del sitio localizadas y procesa el fragmento de experiencia adecuado en función de la localización de la página. Para ello, el fragmento de experiencia debe cumplir las siguientes condiciones.

• El componente Fragmento de experiencia se agrega a una plantilla.
• Esa plantilla se utiliza para crear una nueva página de contenido que forma parte de una estructura localizada por debajo de /content/<site>.
• El fragmento de experiencia al que se hace referencia en una página de contenido forma parte de una estructura de fragmentos de experiencia localizada por debajo de /content/experience-fragments que sigue los mismos patrones que el sitio por debajo de /content/<site>, incluido el uso de los mismos nombres de componentes.

En este caso, el fragmento con la misma localización (idioma, modelo o Live Copy) que la página actual se procesará como parte de la plantilla.

Este comportamiento se limita a los componentes de fragmento de experiencia añadidos a las plantillas. Los componentes de fragmento de experiencia añadidos a páginas de contenido individuales representarán las representaciones exactas de fragmentos de experiencia configuradas dentro del componente.

• Para ver un ejemplo de cómo funcionan las funciones de localización del componente Fragmento de experiencia, consulte la sección a1/>.
• Para ver un ejemplo de cómo funcionan juntas las funciones de localización de los componentes principales, consulte las Características de Localización de la página Componentes principales.

Ejemplo

Supongamos que su contenido tiene este aspecto:

/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

Observe que la estructura siguiente /content/experience-fragments/wknd refleja la estructura de /content/wknd.

En este caso, si el componente Fragmento de experiencia /content/experience-fragments/wknd/us/en/footerTextXf se coloca en una plantilla, las páginas localizadas creadas en función de esa plantilla representarán automáticamente el fragmento de experiencia localizado que corresponde a la página de contenido localizado.

Por lo tanto, si se desplaza a una página de contenido en /content/wknd/ch/de que utiliza la misma plantilla, /content/experience-fragments/wknd/ch/de/footerTextXf se procesará en lugar de /content/experience-fragments/wknd/us/en/footerTextXf.

Visitas en el orden previsto

El componente Fragmento de experiencia intentará encontrar un componente localizado correspondiente en el orden siguiente.

1. Primero trata de encontrar una raíz de idioma.
2. Si no se encuentra, intenta encontrar un modelo.
3. Si no se encuentra, intenta encontrar una Live Copy.
4. Si no se encuentra, el valor predeterminado es el fragmento de experiencia configurado en el componente.

Versión y compatibilidad

La versión actual del componente Fragmento de experiencia es v1, que se introdujo con la versión 2.6.0 de los componentes principales en septiembre de 2019 y se describe en este documento.

En la tabla siguiente se detallan todas las versiones compatibles del componente, las versiones AEM con las que son compatibles las versiones del componente y los vínculos a la documentación de versiones anteriores.

Para obtener más información sobre las versiones y versiones de los componentes principales, consulte el documento Versiones de componentes principales.

Salida de componente de muestra

Para experimentar el componente Fragmento de experiencia y ver ejemplos de sus opciones de configuración, así como los resultados HTML y JSON, visite la Biblioteca de componentes.

Detalles técnicos

La documentación técnica más reciente sobre el componente Fragmento de experiencias se encuentra en GitHub.

Encontrará más detalles sobre el desarrollo de los componentes principales en la documentación para desarrolladores de los componentes principales.

Configurar cuadro de diálogo

El cuadro de diálogo de configuración permite al autor del contenido seleccionar la variación de fragmento de experiencia que se debe representar en la página.

Utilice el botón Abrir cuadro de diálogo de selección para abrir el selector de componentes y elegir qué variación del componente de fragmento de experiencia se agregará a la página de contenido.

Si agrega el componente Fragmento de experiencia a una plantilla, tenga en cuenta que se localizará automáticamente siempre que los fragmentos de experiencia estén localizados, por lo que lo que se procese en la página puede variar con respecto al componente que seleccione explícitamente. Consulte el ejemplo anterior para obtener más información.

También puede definir un ID. Esta opción permite controlar el identificador único del componente en el HTML y en la capa de datos.

• Si se deja en blanco, se genera automáticamente una ID única para usted y se puede encontrar inspeccionando la página resultante.
• Si se especifica un ID, es responsabilidad del autor asegurarse de que sea único.
• Cambiar el ID puede tener un impacto en el seguimiento de CSS, JS y de la capa de datos.

Diálogo de diseño

El cuadro de diálogo de diseño permite al autor de la plantilla definir las opciones disponibles para el autor del contenido que utiliza el componente Fragmento de experiencia y los valores predeterminados establecidos al colocar el componente Fragmento de experiencia.

Ficha Estilos

El componente Fragmento de experiencia admite el sistema de estilo AEM .