Block Bindings API

Définition : La Block Bindings API relie certains attributs de blocs à une source de données dynamique. Elle permet de réutiliser des valeurs de métadonnées ou d’autres fournisseurs sans les recopier dans chaque bloc.

Comprendre et utiliser

À quoi cela sert ?

Cette liaison évite les divergences entre contenu et donnée d’origine : un même attribut peut refléter une valeur fournie par WordPress lors du rendu.

Comment cela fonctionne ?

Disponible depuis WordPress 6.5, l’API s’appuie sur des sources enregistrées et des métadonnées de liaison. Les attributs compatibles et fournisseurs disponibles dépendent des versions et du contexte.

Dans quel contexte l’utiliser ?

À employer lorsqu’un élément du contenu doit suivre une donnée structurée, par exemple une information de publication mise à jour indépendamment de la page.

Cas concret : ATOOLPHA

Un bloc Paragraphe ATOOLPHA pourrait recevoir une valeur de métadonnée publique autorisée au lieu de contenir une copie figée du texte.

Exemple de code commenté

Extrait documentaire : le contexte WordPress du plugin/éditeur et les dépendances décrites sont nécessaires ; ne pas coller dans le contenu d’une page.

{"metadata":{"bindings":{"content":{"source":"core/post-meta","args":{"key":"atoolpha_public_note"}}}}}

Décryptage de l’exemple

L’extrait présente la structure de liaison d’un attribut content vers une clé de métadonnée. Il doit être intégré aux attributs d’un bloc compatible, après enregistrement et exposition appropriée de la métadonnée.

Résultat attendu

Lorsqu’une source prise en charge fournit la valeur, le rendu peut refléter l’information actuelle plutôt qu’un texte recopié manuellement.

Atelier pratique de vérification

Enregistrer une métadonnée publique de test avec le bon type et les droits nécessaires. Configurer une liaison d’attribut compatible, changer la valeur source et recharger le rendu. Vérifier le comportement lorsque la source est vide ou indisponible, puis confirmer qu’aucune donnée privée ne devient publique.

Précautions et limites

Ne pas lier des métadonnées privées à des blocs publics. Vérifier show_in_rest, les types d’attributs acceptés, les contrôles de lecture et la disponibilité du fournisseur dans la version cible.

Contrôle avant intégration dans un plugin

Enregistrer la source et ses permissions sur une installation de test. Confirmer la compatibilité de chaque attribut lié dans la version cible et vérifier que les métadonnées sensibles ne sont pas rendues publiques.

À ne pas confondre

Block Bindings relie des attributs à une source ; Sources d’attributs relit des valeurs depuis le HTML sérialisé du bloc.

Diagnostic et dépannage avancés

Si une liaison ne renvoie rien, vérifier que la source existe, que la clé est enregistrée, que le bloc/attribut est compatible et que les permissions autorisent sa lecture.