Il existe plusieurs services avancés liés au rendu des fragments de contenu. Pour l’utilisation de ces services, les types de ressources de ces composants doivent être connus de la structure de fragments de contenu.
Pour ce faire, définissez la Configuration du composant de fragment de contenu du service OSGi.
Ces informations sont requises dans les cas suivants :
Adobe recommande d’utiliser les composants principaux.
Si vous n’avez pas besoin des services avancés décrits ci-dessous, vous pouvez ignorer cette configuration.
Lorsque vous étendez ou utilisez les composants prêts à l’emploi, il n’est pas recommandé de modifier la configuration OSGi.
Vous pouvez créer de A à Z un composant n’utilisant que l’API de fragments de contenu, sans services avancés. Cependant, dans ce cas, vous devrez développer votre composant de sorte qu’il traite le traitement approprié.
Il est donc recommandé d’utiliser les composants principaux.
Les services qui nécessitent l’enregistrement d’un composant sont les suivants :
Si vous avez besoin d’une ou de plusieurs de ces fonctionnalités, il est alors (généralement) plus facile d’utiliser les services avancés prêts à l’emploi, au lieu de les développer de A à Z.
La configuration doit être liée au service OSGi. Configuration du composant de fragment de contenu:
com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl
Voir Configuration OSGi pour plus d’informations.
Par exemple :
La configuration OSGi est la suivante :
Libellé | Configuration OSGi |
Description |
Type de ressource | dam.cfm.component.resourceType |
Le type de ressource à enregistrer ; par exemple, .
|
Propriété de référence | dam.cfm.component.fileReferenceProp |
Le nom de la propriété qui contient la référence au fragment ; par exemple, fragmentPath ou fileReference |
Propriété d’élément(s) | dam.cfm.component.elementsProp |
Le nom de la propriété qui contient le ou les noms des éléments dont le rendu doit être effectué ; par exemple,elementName |
Propriété de variation |
dam.cfm.component.variationProp |
Le nom de la propriété qui contient le nom de la variation dont le rendu doit être effectué ; par exemple,variationName |
Pour certaines fonctionnalités, votre composant devra respecter des conventions prédéfinies. Le tableau suivant décrit les propriétés à définir, par votre composant, pour chaque paragraphe (c’est-à-dire jcr:paragraph
pour chaque instance de composant) afin que les services puissent les détecter et les traiter correctement.
Nom de la propriété | Description |
paragraphScope |
Propriété de chaîne qui définit le mode de sortie des paragraphes en mode de rendu d’élément unique. Valeurs :
|
paragraphRange |
Propriété de chaîne qui définit la plage de paragraphes à sortir en mode de rendu d’élément unique. Format :
|
paragraphHeadings |
Propriété booléenne qui définit si les en-têtes (par exemple, h1 , h2 , h3 ) sont comptés comme des paragraphes (true ) ou non (false ) |
À titre d’exemple, reportez-vous aux sections suivantes (sur une instance AEM prête à l’emploi) :
/apps/core/wcm/config/com.adobe.cq.dam.cfm.impl.component.ComponentConfigImpl-core-comp-v1.config
Contient :
dam.cfm.component.resourceType="core/wcm/components/contentfragment/v1/contentfragment"
dam.cfm.component.fileReferenceProp="fragmentPath"
dam.cfm.component.elementsProp="elementName"
dam.cfm.component.variationProp="variationName"