Annoncée en 2025, la refonte V4 d’Elementor introduit les éléments atomiques, une architecture de composants pensée pour remplacer à terme le modèle de widgets construit autour de Widget_Base depuis les débuts du plugin. Pour un développeur qui maintient des widgets personnalisés sur plusieurs sites clients, cette évolution ne relève pas d’un simple changement d’interface : elle touche la façon même de déclarer les propriétés d’un composant et de gérer son rendu.
Cet article détaille ce qui change concrètement pour l’écriture d’un widget, ce qui reste compatible avec l’existant, et comment aborder la cohabitation entre widgets classiques et éléments atomiques sur un même site pendant la période de transition.
De Widget_Base aux éléments atomiques
Le modèle historique d’un widget Elementor repose sur l’enregistrement de contrôles via register_controls(), chaque contrôle correspondant à un champ du panneau (texte, couleur, nombre, répéteur), avec un rendu PHP séparé dans render(). Les éléments atomiques introduits en V4 s’appuient à la place sur un schéma de propriétés déclaratif, plus proche de la logique employée par les blocs de l’éditeur natif de WordPress avec leurs attributs typés.
Concrètement, un élément atomique définit ses propriétés (taille, couleur, espacement) sous forme de types de données structurés plutôt que de contrôles d’interface individuels, ce qui permet à Elementor de générer automatiquement à la fois le panneau de réglages et une partie du CSS correspondant, sans que le développeur ait à écrire séparément la logique de rendu de chaque style.
Ce qui reste compatible
Les widgets construits sur Widget_Base continuent de fonctionner normalement sur un site passé à l’éditeur V4 : Elementor maintient la coexistence des deux modèles plutôt que d’imposer une migration forcée. Un widget personnalisé développé pour un client il y a plusieurs années reste donc opérationnel après mise à jour, sans réécriture immédiate obligatoire.
Ce qui change en revanche, c’est l’accès aux nouvelles fonctionnalités propres au système atomique : classes globales, variables de style partagées, et le nouveau système de styles par état (survol, focus, responsive) directement lié au schéma de propriétés. Un widget resté sur l’ancien modèle ne bénéficie pas nativement de ces mécanismes sans adaptation.
Écrire un premier élément atomique simple
La structure d’un élément atomique s’organise autour d’une définition de schéma qui décrit chaque propriété avec son type et ses contraintes, plutôt qu’un empilement de contrôles :
class Atomic_Badge extends \Elementor\Modules\AtomicWidgets\Base\Atomic_Widget_Base {
public static function get_element_type(): string {
return 'atomic-badge';
}
protected static function define_props_schema(): array {
return [
'label' => String_Prop_Type::make()->default( 'Nouveau' ),
'color' => Color_Prop_Type::make(),
];
}
}
Cette écriture réduit sensiblement le code nécessaire pour un composant simple, mais elle demande d’assimiler un vocabulaire nouveau (types de props, schémas) qui n’a pas d’équivalent direct dans l’ancien modèle de contrôles.
Le rendu, séparé du schéma
Le rendu visuel d’un élément atomique reste distinct de la déclaration de son schéma de propriétés, mais la correspondance entre une propriété déclarée et son effet visuel est en grande partie prise en charge par le système de style atomique lui-même, plutôt qu’écrite manuellement en CSS ou en PHP comme c’était le cas pour un widget classique.
Stratégie pour un développeur de widgets sur mesure
- Ne pas réécrire en urgence les widgets existants qui fonctionnent : la cohabitation est prévue et documentée par Elementor lui-même.
- Pour tout nouveau widget destiné à un site qui migrera vers l’éditeur V4 à moyen terme, évaluer si le composant est simple à exprimer en schéma de propriétés ou s’il nécessite une logique de rendu trop spécifique pour le modèle atomique dans son état actuel.
- Suivre la documentation de développement d’Elementor, cette architecture étant encore jeune et sujette à des évolutions d’API dans les mois qui suivent son introduction.
En résumé
Le passage aux éléments atomiques ne rend pas obsolètes les widgets construits sur Widget_Base, mais il ouvre une nouvelle façon d’écrire des composants, plus déclarative et plus proche des standards modernes de composants d’interface. Pour un développeur qui maintient des widgets sur mesure, la priorité immédiate reste de comprendre ce nouveau vocabulaire sans se précipiter à migrer l’existant, tant que l’architecture continue d’évoluer.
