Le bloc Intégration (Embed) technique reste le même code, qu’on veuille intégrer une vidéo YouTube, un tweet ou une piste SoundCloud : seul change le service ciblé, préconfiguré à l’avance. C’est exactement ce que permettent les variations de bloc : plutôt que de créer un bloc entièrement séparé pour chaque cas, une variation présente le même bloc avec un jeu d’attributs de départ différent, sa propre icône et son propre nom dans la bibliothèque de blocs.
Fonctionnement dans WordPress
Une variation se déclare via la clé variations de block.json (ou en JavaScript avec registerBlockVariation()), en précisant un nom, un titre, une icône, des attributs par défaut et, si besoin, un tableau innerBlocks pour préremplir des blocs enfants. Le bloc Embed du cœur de WordPress illustre bien ce mécanisme : une seule implémentation technique, des dizaines de variations pour YouTube, Vimeo, Spotify et d’autres services.
Exemple
"variations": [ {
"name": "video-produit",
"title": "Vidéo produit",
"attributes": { "align": "wide", "ratio": "16:9" }
} ]À ne pas confondre avec
- Un style de bloc, qui n’ajoute qu’une classe CSS d’habillage visuel, alors qu’une variation modifie réellement les attributs de départ, l’icône et parfois la structure interne du bloc.
- Un motif, qui combine plusieurs blocs différents ensemble, alors qu’une variation reste toujours rattachée à un seul et même type de bloc technique.
- Une variation peut être marquée comme « par défaut » (
isDefault: true) pour remplacer l’apparence générique du bloc dans la bibliothèque, un réglage facile à oublier lors de la création d’un bloc à variations multiples.