Documentation AEM Guide des composants principaux

Versions des composants principaux

Dernière mise à jour : 28 avril 2025

Rubriques :
Composants de base

Créé pour :

Développeur
Administration
Utilisateur ou utilisatrice

Les composants principaux sont compatibles avec les installations AEM as a Cloud Service et AEM On-premise.

Historique des versions et compatibilité

Les composants principaux sont conçus pour être flexibles et compatibles avec toutes les versions d’AEM prises en charge. C’est pourquoi une mise à jour des composants peut contenir plusieurs versions du même composant.

Les tableaux ci-dessous illustrent la compatibilité des mises à jour des composants principaux avec les versions des composants contenues dans les mises à jour.

Historique des versions et configuration requise

Le tableau suivant, dont le contenu est disponible sur GitHub avec les détails complets de la mise à jour, donne une vue d’ensemble des versions des composants principaux et de leur compatibilité avec les versions AEM et les versions Java.

Mise à jour	Description	AEM 6.4	AEM 6.5	AEM 6.5 LTS	AEM as a Cloud Service	Java	Date de publication
2.29.0	Cette version a ajouté la prise en charge de la création de versions préliminaires des ressources dans le composant principal des sites et corrige de nombreux bugs.	-	6.5.21.0+	6.5 LTS (disponibilité générale)	En continu	8, 11	21 avril 2025
2.28.0	Cette version corrige de nombreux bugs.	-	6.5.21.0+	6.5 LTS (disponibilité générale)	En continu	8, 11	17 mars 2025
2.27.0	Cette version corrige de nombreux bugs.	-	6.5.21.0+	-	En continu	11	10 septembre 2024
2.26.0	Cette version corrige de nombreux bugs.	-	6.5.21.0+	-	En continu	11	31 juillet 2024
2.25.4	Il s’agit d’une version mineure qui corrige certains échecs informatiques.	-	6.5.21.0+	-	En continu	8, 11	10 mai 2024
2.25.2	Il s’agit d’une version mineure qui corrige certains échecs informatiques.	-	6.5.21.0+	-	En continu	8, 11	9 mai 2024
2.25.0	Cette version prend en charge les recadrages intelligents nommés dans Dynamic Media. Elle comprend des améliorations de performances et d’accessibilité, ainsi que divers correctifs.	-	6.5.21.0+	-	En continu	8, 11	2 mai 2024
2.24.6	Cette version de correctif inclut des améliorations pour l’initialisation de la couche de données.	-	6.5.21.0+	-	En continu	8, 11	22 avril 2024
2.24.4	Cette version de correctif corrige une initialisation du modèle Sling.	-	6.5.21.0+	-	En continu	8, 11	1er avril 2024
2.24.2	Cette version de correctif améliore la stabilité des tests d’intégration.	-	6.5.21.0+	-	En continu	8, 11	22 février 2024
2.24.0	Cette version prend en charge la couche de données du Gestionnaire de balises de Google et comprend divers correctifs.	-	6.5.21.0+	-	En continu	8, 11	14 février 2024
2.23.4	Cette version de correctif comprenait divers correctifs.	-	6.5.17.0+	-	En continu	8, 11	15 septembre 2023
2.23.2	Ce correctif a ajouté un recadrage intelligent Dynamic Media pour les ressources distantes aux composants d’image et de teaser et corrigé un certain nombre de bugs.	-	6.5.17.0+	-	En continu	8, 11	4 août 2023
2.23.0	Cette version a ajouté la prise en charge de ressources distantes Dynamic Media de nouvelle génération.	-	6.5.17.0+	-	En continu	8, 11	6 juin 2023
2.22.12	Cette version de correctif corrige deux problèmes.	-	6.5.14.0+	-	En continu	8, 11	25 mai 2023
2.22.10	Cette version de correctif corrige deux régressions.	-	6.5.14.0+	-	En continu	8, 11	11 mai 2023
2.22.8	Cette version de correctif réintroduit les fonctionnalités qui ont été supprimées accidentellement dans la version précédente.	-	6.5.14.0+	-	En continu	8, 11	9 mai 2023
2.22.6	Cette version de correctif corrige une régression dans le composant Conteneur.	-	6.5.14.0+	-	En continu	8, 11	21 avril 2023
2.22.4	Il s’agit d’une version de correctif qui corrige un problème dans le composant Liste de fragments de contenu.	-	6.5.14.0+	-	En continu	8, 11	5 avril 2023
2.22.2	Il s’agit d’une version de maintenance qui résout deux problèmes introduits dans la version 2.22.0.	-	6.5.14.0+	-	En continu	8, 11	31 mars 2023
2.22.0	Cette version introduit une nouvelle version du composant Liste ainsi que des améliorations de la fonction Teaser et une mise à jour de la Visionneuse PDF et du Carrousel	-	6.5.14.0+	-	En continu	8, 11	9 février 2023
2.21.2	Il s’agit d’une version de correctif qui corrige un problème lié aux composants du teaser des versions v1 et v2.	-	6.5.13.0+	-	En continu	8, 11	12 septembre 2022
2.21.0	Cette version comprend plusieurs améliorations, notamment la publication de l’API LinkHandler, des améliorations du composant Image et de la couche de données, ainsi que des améliorations des composants à plusieurs panneaux.	-	6.5.13.0+	-	En continu	8, 11	12 septembre 2022
2.20.8	Cette version corrige un problème lié à la diffusion des images SVG via l’AdaptiveImageServlet.	-	6.5.13.0+	-	En continu	8, 11	4 août 2022
2.20.6	Cette version de correctif corrige un problème lié au nouveau composant Table des matières.	-	6.5.13.0+	-	En continu	8, 11	7 juillet 2022
2.20.4	Cette version de correctif corrige un problème lié au nouveau composant Table des matières.	-	6.5.13.0+	-	En continu	8, 11	29 juin 2022
2.20.2	Il s’agit d’une version de correctif qui corrige un problème dans le nouveau service de diffusion de ressources optimisées pour le web d’AEMaaCS.	-	6.5.13.0+	-	En continu	8, 11	20 juin 2022
2.20.0	Cette version comprend un nouveau composant Table des matières, prend en charge le service de diffusion de ressources optimisées pour le web d’AEMaaCS et comprend des correctifs.	-	6.5.13.0+	-	En continu	8, 11	9 juin 2022
2.19.0	Cette version ajoute une nouvelle version au Composant de recherche et des fonctionnalités à la fonction Composant de bouton ainsi que de nombreuses améliorations de l’accessibilité et correctifs de bogues.	-	6.5.10.0+	-	En continu	8, 11	7 avril 2022
2.18.8	Cette version corrige un problème pour AEMaaCS.	-	6.5.10.0+	-	En continu	8, 11	17 mars 2022
2.18.6	Il s’agit d’une version de correctif.	-	6.5.10.0+	-	En continu	8, 11	3 mars 2022
2.18.0	Cette version majeure des composants principaux contient les améliorations suivantes : introduction d’un nouveau gestionnaire de liens dans les nouvelles versions de plusieurs composants, nombreuses améliorations en matière dʼaccessibilité et correctifs de bugs.	-	6.5.10.0+ *	-	En continu	8, 11	16 février 2022
2.17.14	Il s’agit d’une version de correctif.	6.4.8.4+	6.5.6.0+	-	En continu	8, 11	13 décembre 2021
2.17.12	Il s’agit d’une version de correctif qui corrige une régression introduite dans la version précédente.	6.4.8.4+	6.5.6.0+	-	En continu	8, 11	1 octobre 2021
2.17.10	Ce correctif améliore les composants Liste et Navigation pour afficher l’URL externe pour les cibles de redirection, active l’héritage des images de page pour la version v2 à venir du composant Teaser et contient des correctifs supplémentaires.	6.4.8.4+	6.5.6.0+	-	En continu	8, 11	31 août 2021
2.17.8	Cette version de correctif Il s’agit d’une version de correctif permettant de corriger une modification rétrocompatible introduite précédemment.	6.4.8.4+	6.5.6.0+	-	En continu	8, 11	2 août 2021
2.17.6	Cette version de correctif prend en charge les cartes du site pour des pages et comprend différentes améliorations d’accessibilité.	6.4.8.4+	6.5.6.0+	-	En continu	8, 11	29 juillet 2021
2.17.2	Cette version de correctif vient corriger la couche de données qui ne fonctionne pas avec AEMaaCS.	6.4.8.4+	6.5.6.0+	-	En continu	8, 11	8 juillet 2021
2.17.0	Cette version comprend des aperçus techniques de nombreuses nouvelles versions de composants prenant en charge les fonctionnalités de gestionnaire de liens, ainsi qu’un aperçu technique d’une fonctionnalité d’image présentée pour le composant de page. Plusieurs correctifs sont également inclus.	6.4.8.4+	6.5.6.0+	-	En continu	8, 11	16 juin 2021
2.16.4	Il s’agit d’une version de correctif permettant de résoudre un problème lié au nouveau gestionnaire de liens.	6.4.8.1+	6.5.5.0+	-	En continu	8, 11	19 mai 2021
2.16.2	Il s’agissait d’une version de correctif qui corrigeait principalement un problème avec le nouveau gestionnaire de liens et ajoutait une amélioration pour la prise en charge des applications de plusieurs pages pour PWA.	6.4.8.1+	6.5.5.0+	-	En continu	8, 11	15 mai 2021
2.16.0	Cette version s’est concentrée sur les améliorations de l’accessibilité et sur l’introduction d’un nouveau gestionnaire de liens dans les composants existants.	6.4.8.1+	6.5.5.0+	-	En continu	8, 11	22 avril 2021
2.15.2	Cette version de correctif corrigeait principalement des problèmes de compatibilité ascendante de la couche de données et de tests informatiques qui échouaient dans certaines situations.	6.4.8.1+	6.5.5.0+	-	En continu	8, 11	16 mars 2021
2.15.0	Cette version comprend la prise en charge des applications web progressives dans le composant Page ainsi que la version 2.0.0 de la couche de données Adobe.	6.4.8.1+	6.5.5.0+	-	En continu	8, 11	23 février 2021
2.14.0	Cette version comprend de nouvelles options pour le composant Incorporer, introduit le slug de marque au niveau de la page, et corrige de nombreux problèmes.	6.4.8.1+	6.5.5.0+	-	En continu	8, 11	9 février 2021
2.13.2	Il s’agissait d’une version de correctif destinée à corriger un problème lié au RTE, utilisé sur AEMaaCS	6.4.8.1+	6.5.5.0+	-	En continu	8, 11	16 décembre 2020
2.13.0	Cette version contient de nouvelles fonctionnalités Dynamic Media pour le composant d’image.	6.4.8.1+	6.5.5.0+	-	En continu	8, 11	4 décembre 2020
2.12.2	Il s’agissait d’une version de correctif pour la version 2.12.0 contenant des corrections mineures.	6.4.8.1+	6.5.5.0+	-	En continu	8, 11	11 novembre 2020
2.12.1	Il s’agissait d’une version de correctif pour la version 2.12.0 servant à corriger un bogue majeur dans le composant d’image.	6.4.8.1+	6.5.5.0+	-	En continu	8, 11	5 novembre 2020
2.12.0	Cette version a introduit un nouveau gestionnaire de formulaires POST ; la possibilité d’inclure des balises CSS, JavaScript et de métadonnées personnalisées via une configuration contextuelle ; et un utilitaire `DataLayerBuilder` destiné à simplifier l’intégration de la couche de données aux composants personnalisés.	6.4.8.1+	6.5.5.0+	-	En continu	8, 11	29 octobre 2020
2.11.0	Cette version a introduit la prise en charge d’AMP.	6.4.8.1+	6.5.5.0+	-	En continu	8, 11	20 juillet 2020
2.10.0	Cette version a introduit le composant Visionneuse PDF.	6.4.8.1+	6.5.5.0+	-	En continu	8, 11	17 juin 2020
2.9.0	Cette version a permis l’intégration à la couche de données client Adobe et introduit le composant Barre de progression.	6.4.8.0+	6.5.4.0+	-	En continu	8, 11	29 mai 2020
2.8.0	Cette version comprend principalement des correctifs ainsi que de petites améliorations.	6.4.4.0+	6.5.0.0+	-	En continu	8, 11	5 décembre 2019
2.7.0	Cette version a introduit le nouveau composant Incorporer.	6.4.4.0+	6.5.0.0+	-	En continu	8, 11	25 septembre 2019
2.6.0	Cette version a introduit le nouveau composant Fragment d’expérience.	6.4.4.0+	6.5.0.0+	-	En continu	8, 11	6 septembre 2019
2.5.0	Les nouveaux composants Accordéon, Bouton, Conteneur et Téléchargement ont été introduits dans cette version.	6.4.2.0+	6.5.0.0+	-	En continu	8, 11	25 juin 2019
2.4.0	Cette version a introduit le composant Liste de fragments de contenu.	6.4.2.0+	6.5.0.0+	-	En continu	8, 11	7 mai 2019
2.3.2	Cette version était axée sur l’amélioration de la bibliothèque de composants, mais contenait également quelques améliorations des fonctionnalités du composant Séparateur.	6.4.2.0+	6.5.0.0+	-	En continu	8	14 mars 2019
2.3.0	Cette version était axée sur la bibliothèque de composants et introduisait le nouveau composant Séparateur, mais elle contenait également quelques améliorations des fonctionnalités du composant Image.	6.4.2.0+	-	-	-	8	11 février 2019
2.2.2	Cette version concernait principalement les correctifs, mais contenait également quelques améliorations des fonctionnalités du composant Carrousel.	6.4.2.0+	-	-	-	8	27 novembre 2018
2.2.0	Cette version a introduit le composant Onglets et le composant Carrousel, ainsi que des améliorations du composant Image, du composant Page et du Composant Titre. Elle a également amélioré le suivi.	6.4.2.0+	–		-	8	16 octobre 2018
2.1.0	Cette version a introduit le composant Teaser, ainsi que des améliorations du composant Image et de nombreux correctifs.	6.4.2.0+	–		-	8	13 juillet 2018
2.0.8	Il s’agissait d’une version de correctif.	6.4.0.0+	–		-	8	12 juin 2018
2.0.6	Cette version a apporté des améliorations au niveau du code, des correctifs de bogues et de petites améliorations, notamment la possibilité de retourner les images dans le composant Image.	6.4.0.0+	-	-	-	8	11 avril 2018
2.0.4	Cette version était principalement axée sur les améliorations au niveau du code, les correctifs de bogues, ainsi que quelques améliorations mineures apportées au composant Image, au composant Page et au composant Fragment de contenu.	6.4.0.0+	-	-	8	7 mars 2018
2.0.0	Cette version a introduit le composant Navigation, le composant Navigation linguistique, ainsi que le composant Recherche rapide, et a mis en œuvre le Système de style pour tous les composants.	6.4.0.0+	-	-	-	8	16 janvier 2018
1.1.0	Cette version a mis en œuvre l’exportation JSON sur tous les composants et introduit le composant Fragment de contenu.	6.4.0.0+	–		-	8	10 octobre 2017
1.0.6	Cette version a ajouté plusieurs correctifs pour le composant Image.	6.4.0.0+	-	-	8	4 août 2017
1.0.4	Cette version a ajouté des correctifs pour le composant de page, le composant Image, ainsi que divers correctifs et améliorations globaux.	6.4.0.0+	–		-	8	26 avril 2017
1.0.2	Cette version a ajouté des correctifs pour les images GIF animées dans le composant Image.	6.4.0.0+	-	-	-	7	22 mars 2017
1.0.0	Version initiale des composants principaux.	6.4.0.0+	-	-	-	7	20 mars 2017

TIP

Comme avec AEM, Adobe conseille aux développeurs d’utiliser la mise à jour et les versions les plus récentes disponibles des composants principaux, compatibles avec la version d’AEM qu’ils exécutent pour bénéficier des correctifs et fonctionnalités les plus récents.

Versions et versions des composants

Le tableau suivant répertorie les versions des composants contenus dans les versions des composants principaux.

	Version 1.0.0 - 1.0.6	Version 1.1.0	Version 2.0.0 - 2.0.8	Version 2.1.0	Version 2.2.0 - 2.2.0	Version 2.3.0 - 2.3.2	Version 2.4.0	Version 2.5.0	Version 2.6.0	Version 2.7.0 - 2.8.0	Version 2.9.0-2.17.14	Version 2.18.0	Version 2.19.0	Version 2.20.0-2.21.2	Version 2.22.0+
Page	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2, v3	v1, v2, v3	v1, v2, v3	v1, v2, v3
Titre	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2, v3	v1, v2, v3	v1, v2, v3	v1, v2, v3
Image	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2, v3	v1, v2, v3	v1, v2, v3	v1, v2, v3
Liste	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2, v3	v1, v2, v3	v1, v2, v3	v1, v2, v3, v4
Chemin de navigation	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2, v3	v1, v2, v3	v1, v2, v3	v1, v2, v3
Partage sur les médias sociaux	v1	v1	v1	v1	v1	v1	v1	v1	v1	v1	v1	v1, obsolète	v1, obsolète	v1, obsolète	v1, obsolète
Conteneur de formulaires	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2
Texte du formulaire	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2
Options du formulaire	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2
Formulaire masqué	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2
Bouton de formulaire	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2
Fragment de contenu		Sandbox	v1	v1	v1	v1	v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2
Navigation			v1	v1	v1	v1	v1	v1	v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Navigation par langue			v1	v1	v1	v1	v1	v1	v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Recherche rapide			v1	v1	v1	v1	v1	v1	v1	v1	v1	v1	v1, v2	v1, v2	v1, v2
Teaser				v1	v1	v1	v1	v1	v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Onglets					v1	v1	v1	v1	v1	v1	v1	v1	v1	v1	v1
Carrousel					v1	v1	v1	v1	v1	v1	v1	v1	v1	v1	v1
Séparateur						v1	v1	v1	v1	v1	v1	v1	v1	v1	v1
Liste de fragments de contenu							v1	v1	v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Accordéon								v1	v1	v1	v1	v1	v1	v1	v1
Bouton								v1	v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Conteneur								v1	v1	v1	v1	v1	v1	v1	v1
Téléchargement								v1	v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Fragment d’expérience									v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Incorporer										v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Barre de progression											v1	v1	v1	v1	v1
Visionneuse PDF											v1	v1	v1	v1	v1
Table des matières														v1	v1

Versions et mises à jour

Les composants principaux sont distribués via GitHub. Cela permet à Adobe d’ajouter plus rapidement des fonctionnalités aux composants et d’autoriser la saisie de la communauté en dehors du cycle de publication AEM.

Les composants principaux sont disponibles avec les versions AEM définies avec lesquelles ils sont compatibles. Cela signifie qu’une version AEM peut prendre en charge plusieurs versions ou mises à jour des composants principaux.

Versions

Les versions principales constituent l’itération majeure des composants principaux. Chaque composant possède une version. Les versions sont signalées avec la valeur v inscrite avec un entier positif non nul, comme v1 et v2. Les versions ne sont incrémentées que pour les modifications qui ne sont pas rétrocompatibles, ce qui est normalement le cas pour l’introduction de nouvelles fonctionnalités et fonctions.

Les développeurs et les administrateurs peuvent reconnaître les versions des composants principaux par un numéro figurant dans leurs chemins d’accès aux types de ressources et dans les noms de classe Java pleinement qualifiés de leurs implémentations. Ce numéro de version représente une version majeure définie par les directives de contrôle de version sémantique.

Pour plus d’informations sur les versions des composants principaux, voir la documentation destinée aux développeurs des composants principaux.

Mises à jour

Les composants principaux sont disponibles par l’intermédiaire des mises à jour et représentent les artefacts publiés réels disponibles sur GitHub. Les versions sont signalées par un nombre décimal au format X.Y.Z et rassemblent tous les composants principaux en tant que package livrable.

Les versions majeures contiennent les éléments suivants : introduction de composants entièrement nouveaux, améliorations apportées aux versions existantes des composants et correctifs standard. Elles sont représentées par un incrément dans le composant X du numéro de version.
Les versions mineures contiennent les éléments suivants : introduction de nouveaux composants, ajout de nouvelles fonctionnalités aux versions existantes des composants et divers correctifs. Elles sont représentées par un incrément dans le composant Y du numéro de version.
Les versions de correctif contiennent uniquement des correctifs. Elles sont représentées par un incrément dans le composant Z du numéro de version.

NOTE

Les versions peuvent contenir plusieurs versions du même composant.

La même version d’un composant peut apparaître dans plusieurs versions.

Prise en charge des composants principaux

Les composants principaux font partie intégrante d’AEM et sont pris en charge selon les mêmes conditions que s’ils étaient fournis dans le cadre du Quickstart.

À l’instar des autres fonctionnalités du produit, la règle générale de fin de vie est la suivante :

Les composants sont d’abord annoncés comme étant obsolètes avant d’être supprimés
Ils sont ensuite retirés au plus tôt de la version d’AEM après l’annonce.

Les clients disposent ainsi d’au moins un cycle de publication pour passer à la nouvelle version du composant avant la fin de la prise en charge.

La version de chaque composant indique clairement les versions d’AEM prises en charge. Lorsque la prise en charge d’une version d’AEM est interrompue, la prise en charge des composants principaux de cette version d’AEM est prise en charge.

Pour plus d’informations sur la prise en charge des personnalisations des composants, consultez la page Personnalisation des composants principaux de la version des composants principaux appropriée.