# Liaison de données

> La liaison de données (Block Bindings) connecte un attribut de bloc à une source externe, comme un champ personnalisé, pour que sa valeur affichée provienne de cette source plutôt que d'un texte saisi manuellement.

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

Afficher le prix d'un produit stocké dans un champ personnalisé, à l'intérieur d'un simple bloc Paragraphe, obligeait auparavant à créer un bloc dynamique sur mesure rien que pour cet usage. L'API de liaison de données, introduite dans WordPress 6.5, simplifie ce besoin : elle permet de relier directement un attribut d'un bloc natif (le contenu d'un Paragraphe, l'URL d'une Image) à une source de données déclarée par du code, sans écrire de nouveau bloc.

## Fonctionnement dans WordPress

Une source se déclare côté PHP avec `register_block_bindings_source()`, en fournissant une fonction qui retourne la valeur à afficher pour un contexte donné. Le bloc, lui, référence cette source via la propriété `metadata.bindings` dans ses attributs, ce qui verrouille visuellement le champ concerné dans l'éditeur (il devient en lecture, relié à la source plutôt qu'à un texte libre). La source native `core/post-meta` couvre déjà le cas le plus courant : lier un champ personnalisé d'article.

## Exemple

```
<!-- wp:paragraph {"metadata":{"bindings":{"content":{
  "source":"core/post-meta","args":{"key":"prix_produit"}
}}}} -->
<p>Valeur remplacée par la liaison</p>
<!-- /wp:paragraph -->
```

## À ne pas confondre avec

- Un bloc dynamique complet, qui reste nécessaire pour une logique de rendu plus riche que la simple substitution d'une valeur dans un attribut existant.
- L'API d'interactivité, qui gère le comportement côté visiteur après le rendu, alors que la liaison de données agit au moment de la génération du contenu, avant tout affichage.
- Un champ personnalisé classique affiché via un shortcode ou du code PHP dans un gabarit : la liaison de données reste, elle, gérée depuis l'interface de l'éditeur, bloc par bloc.
