Composant Incorporer

Le composant Incorporer des composants principaux permet d’incorporer du contenu externe dans une page de contenu AEM.

Utilisation

Le composant Incorporer des composants principaux permet à l’auteur de contenu de définir le contenu externe sélectionné à incorporer dans une page de contenu AEM. En outre, une option permet de définir du code HTML de forme libre à incorporer.

Version et compatibilité

La version actuelle du composant Incorporer est v1, qui a été introduite avec la version 2.7.0 des composants principaux en septembre 2019. Elle est décrite dans ce document.

Le tableau ci-après présente en détail toutes les versions prises en charge du composant, les versions AEM avec lesquelles les versions du composant sont compatibles et les liens vers la documentation pour les versions précédentes.

Version du composant AEM 6.4 AEM 6.5 AEM as a Cloud Service
v1 Compatible Compatible Compatible

Pour plus d’informations sur les versions et les publications des composants principaux, voir le document sur les versions des composants principaux.

Exemple de sortie de composant

Pour tester le composant Incorporer et obtenir des exemples d’options de configuration, ainsi que des sorties HTML et JSON, consultez la Bibliothèque de composants.

Détails techniques

La documentation technique la plus récente sur le composant Incorporer se trouve sur GitHub.

Vous trouverez plus d’informations sur le développement des composants principaux dans la documentation destinée aux développeurs de composants principaux.

Boîte de dialogue de configuration

La boîte de dialogue de configuration permet à l’auteur de contenu de définir la ressource externe à incorporer dans la page. Sélectionnez d’abord le type de ressource à incorporer :

Pour chaque type d’intégration, vous pouvez définir un ID de publicité. Cette option permet de contrôler l’identifiant unique du composant dans le code HTML et dans la couche de données.

  • Si rien n’est indiqué, un ID unique est généré automatiquement et peut être trouvé en examinant la page obtenue.
  • Si un ID est spécifié, il incombe à l’auteur de s’assurer qu’il est unique.
  • La modification de l’ID peut avoir un impact sur le suivi CSS, JS et de couche de données.

URL

L’incorporation la plus simple se fait par le biais d’une URL. Il vous suffit de coller l’URL de la ressource à incorporer dans le champ URL. Le composant tente d’accéder à la ressource. Si le rendu peut être effectué par l’un des processeurs, il affiche un message de confirmation sous le champ URL. Si ce n’est pas le cas, le champ sera indiqué comme étant dans un état d’erreur.

Le composant Incorporer est fourni avec des processeurs pour les types de ressources suivants :

  • les ressources conformes à la norme oEmbed, notamment Facebook Post, Instagram, SoundCloud, Twitter et YouTube ;
  • Pinterest.

Les développeurs peuvent ajouter d’autres processeurs d’URL en consultant la documentation sur le composant Incorporer destinée aux développeurs.

Boîte de dialogue de modification du composant Incorporer pour l’URL

Élément intégrable

Les éléments intégrables permettent une plus grande personnalisation de la ressource incorporée, qui peut être paramétrée et inclure des informations supplémentaires. Un auteur peut choisir parmi des éléments incorporables de confiance préconfigurés et le composant est livré avec un élément YouTube intégré prêt à l'emploi.

Le champ Élément intégrable définit le type de processeur que vous souhaitez utiliser. Dans le cas de l’élément intégrable YouTube, vous pouvez ensuite définir les éléments suivants :

  • ID de la vidéo : identifiant vidéo unique de YouTube de la ressource que vous souhaitez incorporer.
  • Largeur : largeur de la vidéo incorporée.
  • Hauteur : hauteur de la vidéo incorporée.
  • Activer le muet : ce paramètre indique si la lecture de la vidéo est muée par défaut. L’activation de cette option augmente le risque de fonctionnement de la lecture automatique dans les navigateurs modernes.
  • Activer la lecture automatique : ce paramètre indique si la lecture de la vidéo initiale se début automatiquement au chargement du lecteur. Cela ne s’applique qu’à l’instance de publication ou lors de l’utilisation de l’option Vue as Published sur l’instance de création.
  • Activer la boucle : dans le cas d’une vidéo unique, ce paramètre indique si le lecteur doit lire la vidéo initiale à plusieurs reprises. Dans le cas d’une liste de lecture, le lecteur lit l’intégralité de la liste de lecture, puis début de nouveau à la première vidéo.
  • Activer la lecture en ligne (iOS) : ce paramètre contrôle si les vidéos sont lues en ligne (on) ou en plein écran (off) dans un lecteur HTML5 sous iOS.
  • Vidéos connexes sans restriction - Si cette option est désactivée, les vidéos associées proviennent du même canal que la vidéo qui vient d'être lue, sinon elles proviennent de n'importe quel canal.

Notez que les options "activer" doivent être activées dans la boîte de dialogue de conception Conception et peuvent être définies comme valeurs par défaut.

D’autres éléments intégrables proposent des champs similaires et peuvent être définis par un développeur en consultant la documentation sur le composant Incorporer destinée aux développeurs.

Boîte de dialogue de modification du composant Incorporer pour les éléments intégrables

REMARQUE

Pour être accessibles à l’auteur de la page, les éléments intégrables doivent être activés au niveau du modèle au moyen de la boîte de dialogue de conception.

HTML

Vous pouvez ajouter du code HTML de forme libre à votre page à l’aide du composant Incorporer.

Boîte de dialogue de modification du composant Incorporer pour le code HTML

REMARQUE

Les balises non sécurisées, telles que les scripts, sont filtrées à partir du code HTML entré et ne sont pas affichées sur la page obtenue.

Sécurité

Les balises HTML que l’auteur peut entrer sont filtrées à des fins de sécurité pour éviter toute attaque de script entre sites qui pourrait permettre aux auteurs d’obtenir des droits d’administration, par exemple.

En règle générale, tous les scripts et les élémentsstyle, ainsi que tous les attributs on* et style sont supprimés de la sortie.

Cependant, les règles sont plus complexes parce que le composant incorporé suit AEM ensemble de règles de filtrage de structure d'assainissement HTML AntiSamy global, qui se trouve à /libs/cq/xssprotection/config.xml. Cela peut être superposé pour une configuration spécifique au projet par un développeur, si nécessaire.

Vous trouverez des informations de sécurité supplémentaires dans la documentation du développeur AEM pour les installations On-Premise, ainsi que les installations AEM as a Cloud Service.

REMARQUE

Bien que les règles de structure d’assainissement AntiSamy puissent être configurées en superposant /libs/cq/xssprotection/config.xml, ces modifications ont un impact sur l’ensemble du comportement HTL et JSP et pas seulement sur le composant principal Incorporer.

Boîte de dialogue de conception

La boîte de dialogue de conception permet à l’auteur du modèle de définir les options disponibles pour l’auteur du contenu qui utilise le composant Incorporer et les valeurs par défaut définies lors du placement de celui-ci.

Onglet Types incorporables

Boîte de dialogue de conception du composant Incorporer

  • URL de désactivation : lorsque cette option est sélectionnée, elle désactive l’option URL pour l’auteur de contenu.
  • Désactiver les éléments intégrables : lorsque cette option est sélectionnée, elle désactive l’option Élément intégrable pour l’auteur de contenu, quels que soient les processeurs intégrables autorisés.
  • Désactiver HTML : lorsque cette option est sélectionnée, elle désactive l’option HTML pour l’auteur de contenu.
  • Embeddables autorisés - Multisélection qui définit les processeurs incorporables disponibles pour l'auteur du contenu, à condition que l'option ​Embeddableoption soit principale.

Onglet YouTube

Onglet YouTube de la boîte de dialogue de conception du composant incorporé

  • Autoriser la configuration du comportement silencieux : permet à l'auteur du contenu de configurer l' option Activer la sélection dans le composant lorsque le type d'intégration YouTube est sélectionné.
    • Valeur par défaut du paramètre mute : définit automatiquement l’ option Activer la sélection lorsque le type d’intégration YouTube est sélectionné.
  • Autoriser la configuration du comportement de lecture automatique : permet à l’auteur du contenu de configurer l’option Activer la lecture automatique dans le composant lorsque le type d’intégration YouTube est sélectionné.
    • Valeur par défaut de la lecture automatique : définit automatiquement l’option Activer la lecture automatique lorsque le type d’intégration YouTube est sélectionné.
  • Autoriser la configuration du comportement de boucle : permet à l'auteur du contenu de configurer l' option Activer la boucle dans le composant lorsque le type d'intégration YouTube est sélectionné.
    • Valeur par défaut de la boucle : définit automatiquement l’ option Activer la boucle lorsque le type d’intégration YouTube est sélectionné.
  • Autoriser la configuration de la lecture en ligne (iOS) : permet à l’auteur du contenu de configurer l’ option Activer la lecture en ligne (iOS)dans le composant lorsque le type d’intégration YouTube est sélectionné.
    • Valeur par défaut de la lecture en ligne (iOS) : définit automatiquement l’ option Activer la lecture en ligne (iOS)lorsque le type d’intégration YouTube est sélectionné.
  • Autoriser la configuration des vidéos intégrées : permet à l'auteur du contenu de configurer l'option Vidéos liées sans restriction dans le composant lorsque le type d'intégration YouTube est sélectionné.
    • Valeur par défaut des vidéos liées sans restriction - Définit automatiquement l’option Vidéos liées sans restriction lorsque le type d’intégration YouTube est sélectionné.

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free