Block Bindings API

WordPress 🟡 Mid

Définition

API disponible depuis WordPress 6.5 qui lie un attribut de bloc (contenu d'un paragraphe, url d'une image, texte d'un bouton…) à une source de données, sans bloc personnalisé. La source core/post-meta lit un champ enregistré avec show_in_rest ; register_block_bindings_source() crée ses propres sources.

Analogie

Un champ de publipostage : le gabarit reste le même, la valeur vient de la fiche.

Exemple de code

// PHP : exposer la méta
register_meta('post', 'prix', [
  'show_in_rest' => true, 'single' => true, 'type' => 'string',
]);

/* Markup du bloc :
<!-- wp:paragraph {"metadata":{"bindings":{
  "content":{"source":"core/post-meta","args":{"key":"prix"}}
}}} -->
<p>Valeur de repli</p>
<!-- /wp:paragraph -->
*/

Cas d'usage

Afficher des champs personnalisés (ACF, méta natives) dans des blocs standards, dans les gabarits de l'éditeur de site.

Anti-pattern

Lier une méta dont la clé commence par un underscore ou non exposée en REST : la liaison est ignorée.
#core#wordpress

Fiche mise à jour le 2026-09-27

← → au clavier pour passer d'une fiche à l'autre