# API d’interactivité

> L'API d'interactivité est un standard introduit dans WordPress 6.5 pour rendre les blocs interactifs côté visiteur avec un minimum de JavaScript, sans dépendre d'un framework front lourd.

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

Un accordéon qui s'ouvre au clic, un panier qui se met à jour, une pagination sans rechargement de page : ce genre d'interactivité obligeait auparavant chaque extension à écrire son propre JavaScript, souvent redondant d'un bloc à l'autre. L'API d'interactivité propose à la place un modèle commun, basé sur des directives déclarées directement dans le balisage HTML (`data-wp-on--click`, `data-wp-bind--hidden`, `data-wp-text`) et sur un état partagé, léger et réactif.

## Fonctionnement dans WordPress

Un bloc dynamique qui adopte cette API enregistre un module de vue côté client avec `viewScriptModule` dans `block.json`, définit un état ou un contexte via `store()` depuis le paquet `@wordpress/interactivity`, puis relie ce state aux directives présentes dans le rendu PHP du bloc. Le cœur de WordPress l'utilise déjà pour des blocs comme la pagination de la Boucle de requête ou l'agrandissement d'image, sans que ces blocs embarquent leur propre bibliothèque JavaScript.

## Exemple

```
<div data-wp-interactive="mon-plugin" data-wp-context='{"ouvert": false}'>
  <button data-wp-on--click="actions.basculer">Afficher</button>
  <p data-wp-bind--hidden="!context.ouvert">Contenu révélé</p>
</div>
```

## À ne pas confondre avec

- React, utilisé dans l'éditeur pour construire l'interface d'administration : l'API d'interactivité cible le site public vu par les visiteurs, avec un moteur de rendu beaucoup plus léger.
- Le rendu côté serveur classique d'un bloc dynamique, qui produit du HTML statique ; l'API d'interactivité ajoute une couche réactive par-dessus ce HTML, sans le régénérer entièrement.
- Un framework JS complet comme Vue ou Alpine.js, dont l'API d'interactivité reprend certaines idées de directives déclaratives sans en dépendre.