theme.json

Avant ce fichier, chaque réglage visuel d’un thème vivait dans un endroit différent : le Personnaliseur pour les couleurs, des fonctions PHP pour les tailles de police, du CSS écrit à la main pour les espacements. theme.json unifie tout cela dans un seul fichier structuré, lu à la fois par l’éditeur et par le rendu final du site.

Deux grandes sections

La clé settings détermine ce que l’utilisateur peut modifier (palettes, tailles disponibles, activation des contrôles d’espacement), tandis que la clé styles fixe les valeurs par défaut réellement appliquées. Un thème bloc en dépend structurellement, mais un thème classique ou hybride peut aussi l’inclure pour bénéficier de certaines fonctionnalités sans devenir un thème bloc complet.

Squelette typique

{
  "$schema": "https://schemas.wp.org/trunk/theme.json",
  "version": 3,
  "settings": { "color": { "palette": [] } },
  "styles": { "color": { "background": "#ffffff" } },
  "templateParts": []
}

Pièges fréquents

• Le champ version doit correspondre au schéma utilisé (la version 3 est la plus récente) ; un mauvais numéro peut entraîner des réglages ignorés ou mal interprétés par WordPress.
• Un thème enfant hérite de theme.json depuis son parent seulement s’il ne fournit pas son propre fichier : dès qu’il en déclare un, celui-ci remplace entièrement, et non partiellement, celui du parent.
• Les styles globaux enregistrés par l’utilisateur via l’éditeur de site sont stockés en base de données et prennent le pas sur les valeurs par défaut de theme.json, jusqu’à une éventuelle réinitialisation.