La grande majorité des blocs natifs de WordPress, du Paragraphe à l’Image en passant par le Titre, fonctionnent selon ce principe simple : ce que l’éditeur affiche est, à quelques classes près, exactement ce qui sera stocké et servi aux visiteurs. C’est ce qu’on appelle un bloc statique. Sa fonction save retourne le balisage HTML complet, qui est ensuite figé dans le contenu de l’article, entre des commentaires délimiteurs qui permettent à l’éditeur de le reconnaître au chargement suivant.
Fonctionnement dans WordPress
Comme le HTML est déjà écrit en base de données, l’affichage du site n’a besoin d’aucune exécution PHP particulière pour ce bloc : WordPress se contente de renvoyer le contenu de l’article tel quel, ce qui rend ce type de bloc très rapide à servir. Le prix à payer se voit à l’édition : si la structure du HTML généré par save change dans une future version du bloc, les blocs déjà enregistrés avec l’ancienne structure doivent être migrés via un mécanisme de « deprecated », sous peine d’afficher une erreur de validation.
Exemple
// Fonction save() d'un bloc statique
export default function save( { attributes } ) {
return <p className="mon-bloc">{ attributes.texte }</p>;
}À ne pas confondre avec
- Le bloc dynamique, dont le rendu final est recalculé côté serveur à chaque affichage plutôt que figé au moment de l’écriture.
- Un motif, qui n’est qu’un assemblage prédéfini de blocs (statiques ou dynamiques) inséré comme point de départ, sans mécanisme de rendu propre.
- Une révision d’article, qui concerne l’historique des modifications successives, alors que la nature statique ou dynamique d’un bloc décrit son mode de rendu, pas son historique.