Block Supports

Définition : Block Supports est le système WordPress qui déclare quelles options standard un bloc expose, notamment les couleurs, espacements, alignements et réglages typographiques. Il évite de recréer chaque contrôle manuellement.

Comprendre et utiliser

À quoi cela sert ?

Grâce à ses déclarations, l’éditeur peut offrir des outils homogènes et produire les classes ou styles nécessaires selon les capacités du thème.

Comment cela fonctionne ?

La propriété supports se définit généralement dans block.json. Les caractéristiques disponibles varient selon le type de bloc, la version du Core et les choix du thème.

Dans quel contexte l’utiliser ?

À utiliser lorsqu’un bloc personnalisé doit proposer les mêmes réglages de présentation qu’un bloc natif sans dupliquer une interface complexe.

Cas concret : ATOOLPHA

Un encadré ATOOLPHA autorise la couleur du texte et du fond, tout en interdisant un alignement large inadapté à son contexte.

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.

{"supports":{"color":{"text":true,"background":true},"spacing":{"padding":true},"align":false}}

Décryptage de l’exemple

Les options activent les supports déclarés, sous réserve des réglages globaux. Les propriétés d’enveloppe doivent être propagées par le rendu statique ou dynamique pour afficher les valeurs choisies.

Résultat attendu

L’éditeur peut proposer les contrôles correspondants lorsque l’environnement autorise ces fonctionnalités.

Atelier pratique de vérification

Déclarer le support des couleurs d’un bloc simple et vérifier la présence des contrôles dans l’éditeur. Tester un thème qui autorise moins de réglages et observer les différences. Sauvegarder une couleur et contrôler sa traduction en classes ou styles dans le HTML produit sur le site public.

Précautions et limites

Les supports n’assurent pas seuls l’application correcte des styles. Vérifier useBlockProps.save() ou get_block_wrapper_attributes() selon le mode de rendu.

Contrôle avant intégration dans un plugin

Inspecter les propriétés effectivement sérialisées et tester la sortie publique avec deux thèmes aux capacités différentes. Déclarer une option supports ne garantit pas que le thème l’autorisera ni que le CSS sera disponible.