# Transformation de bloc

> Une transformation de bloc convertit un bloc existant en un autre type de bloc, en tentant de conserver ce qui peut l'être, comme le texte ou les images qu'il contenait.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/transformation-de-bloc/

Après avoir rédigé une liste de points sous forme de plusieurs paragraphes, la reprendre entièrement pour en faire une vraie liste à puces serait fastidieux. La transformation de bloc évite ce travail : depuis le sélecteur de bloc dans la barre d'outils, un menu propose les types de blocs compatibles vers lesquels basculer, avec une tentative de conservation intelligente du contenu, par exemple le texte d'un Paragraphe qui devient le premier élément d'une Liste.

## Fonctionnement dans WordPress

Chaque bloc peut déclarer ses transformations possibles via la propriété `transforms` de sa configuration, avec deux directions : `from` (comment ce bloc peut naître d'un autre type) et `to` (vers quels types il peut se convertir). Une transformation peut aussi s'appliquer à un groupe de blocs sélectionnés ensemble, comme convertir plusieurs blocs Image en un unique bloc Galerie, ou à un simple motif de saisie reconnu automatiquement (taper `##` en début de ligne transforme le Paragraphe en Titre de niveau 2).

## Exemple

```
transforms: {
  to: [ {
    type: 'block',
    blocks: [ 'core/heading' ],
    transform: ( { content } ) => createBlock( 'core/heading', { content } ),
  } ],
}
```

## Bon à savoir

- Une transformation n'est pas toujours réversible à l'identique : convertir une Liste en Paragraphes uniques peut faire perdre la structure de puces d'origine si l'on revient ensuite en arrière.
- Les blocs proposés dans le menu de transformation dépendent des transformations réellement déclarées par chaque bloc, pas d'une compatibilité générique automatique entre tous les blocs du site.