Le composant Incorporer des composants principaux permet d’incorporer du contenu externe dans une page de contenu AEM.
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.
Ce document décrit la version v1 du composant Incorporer, qui a été introduite avec la version 2.7.0 des composants principaux en septembre 2019.
Ce document décrit la version v1 du composant Incorporer.
Pour plus d’informations sur la version actuelle du composant Incorporer, consultez le document Composant Incorporer.
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.
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.
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.
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 développeurs peuvent ajouter d’autres processeurs d’URL en consultant la documentation sur le composant Incorporer destinée aux développeurs.
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 effectuer un choix parmi des éléments intégrables approuvés préconfigurés. De plus, le composant est fourni avec un élément intégrable YouTube 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 :
Notez que les options doivent être activées dans la boîte de dialogue de 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.
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.
Vous pouvez ajouter du code HTML de forme libre à votre page à l’aide du composant Incorporer.
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.
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.
Toutefois, les règles sont plus complexes, car le composant Incorporer suit l’ensemble de règles de filtrage de la structure d’assainissement HTML AntiSamy d’AEM, qui se trouve à l’adresse /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.
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.
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.