Aller au contenu

Dennis · 19 mai 2026

Blockstudio 7.3

Blockstudio 7.3 ajoute une nouvelle couche au framework : des composants UI réutilisables, qui peuvent être rendus comme n’importe quel autre bloc.

Alors que la version 7.1 a transformé les blocs en applications full stack et que la version 7.2 a facilité l’inspection, la validation et la distribution des grands projets, la version 7.3 se concentre sur l’expérience quotidienne de création et de modification de ces applications.

En bref :

  • Composants UI : bibliothèque de composants bsui/* intégrée et facultative, reposant sur l’WordPress Interactivity API.
  • Applications : exemples app/* intégrés montrant comment les composants UI s’assemblent pour former des interfaces plus riches.
  • Éditeur étendu : panneau latéral plus large pour modifier les champs Blockstudio lorsque la barre latérale devient trop étroite.
  • Sélecteurs de ressources ciblés : les ressources CSS et SCSS peuvent utiliser %selector% pour cibler directement la classe du conteneur de bloc.
  • Dépendances d’extensions : les blocs peuvent exiger des extensions WordPress actives, avec des contraintes de version facultatives.
  • Règles de l’éditeur : blockstudio.json peuvent configurer les blocs globaux, les compositions et le comportement des médias à l’aide de hooks de l’éditeur reposant sur WordPress PHP.
  • Alias de balises de bloc : alias personnalisés pour la création de balises de bloc.
  • Analyse statique et documentation : meilleure prise en charge de PHPStan pour les bibliothèques de blocs externes, ainsi que génération de documentation pour les réglages et les hooks.
  • Correctifs pour les pages et l’éditeur : analyse plus fiable des pages à partir de fichiers, détection de candidats Tailwind, mode de réinitialisation, isolation du cache de rendu et préchargements de l’éditeur.

Bibliothèque UI

La version 7.3 comprend une bibliothèque de composants intégrée et des exemples d’applications construits avec celle-ci.

Composants UI

Blockstudio 7.3 comprend une bibliothèque UI intégrée sous l’espace de noms bsui/*. Ces composants sont des blocs Blockstudio classiques : vous pouvez donc les utiliser dans les modèles, les pages à partir de fichiers, les compositions et le contenu des publications, avec la même syntaxe de balise de bloc que celle que vous utilisez déjà.

La bibliothèque de composants UI est en version bêta pendant que nous recueillons davantage de retours. L’objectif de la version 7.3 est de proposer le premier ensemble de composants, d’apprendre des projets réels et d’affiner les noms, le comportement et les valeurs par défaut avant de déclarer stable la surface API.

La bibliothèque est facultative :

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "ui": {
    "enabled": true
  }
}

Une fois activés, les composants simples peuvent être rendus directement :

HTML
<block name="bsui/button" label="Save" variant="default"></block>
<block name="bsui/badge" label="Beta"></block>
<block
  name="bsui/input"
  nameAlt="email"
  type="email"
  placeholder="Email"
></block>

La syntaxe plus courte bs: fonctionne également :

HTML
<bs:bsui-button label="Save" variant="default" />

Le but n’est pas de transformer Blockstudio en boîte à outils UI de création de pages. Il s’agit de rendre disponibles des éléments d’interface courants sous forme de blocs, afin que les applications créées avec Blockstudio n’aient pas à recréer des boutons, des boîtes de dialogue, des onglets, des sélecteurs, des champs de formulaire, des menus, des barres d’outils et des composants de retour d’information dans chaque projet.

Le premier ensemble de composants comprend des éléments de mise en page, d’action, de saisie, de superposition, de navigation, de retour d’information, de formulaire et d’affichage des données :

  • bsui/button, bsui/button-group, bsui/toggle, bsui/toggle-group, bsui/toolbar
  • bsui/input, bsui/textarea, bsui/select, bsui/checkbox, bsui/radio-group, bsui/slider, bsui/switch, bsui/number-field, bsui/password-input, bsui/phone-input, bsui/otp-input, bsui/date-input, bsui/time-picker
  • bsui/dialog, bsui/drawer, bsui/popover, bsui/menu, bsui/context-menu, bsui/menubar, bsui/tooltip, bsui/alert-dialog
  • bsui/tabs, bsui/accordion, bsui/breadcrumb, bsui/pagination, bsui/navigation-menu
  • bsui/card, bsui/table, bsui/stack, bsui/separator, bsui/aspect-ratio, bsui/badge, bsui/avatar, bsui/progress, bsui/meter, bsui/skeleton, bsui/spinner, bsui/kbd
  • bsui/form, bsui/field, bsui/field-group, bsui/file-upload, bsui/color-picker, bsui/rating

Beaucoup sont des blocs composés. Un bloc bsui/tabs gère l’état interactif, tandis que les blocs enfants tels que bsui/tabs-list, bsui/tabs-trigger et bsui/tabs-panel en décrivent la structure.

HTML
<block name="bsui/tabs" defaultValue="features">
  <block name="bsui/tabs-list">
    <block name="bsui/tabs-trigger" value="features" title="Features"></block>
    <block name="bsui/tabs-trigger" value="pricing" title="Pricing"></block>
  </block>
  <block name="bsui/tabs-panel" value="features">
    <p>Features content.</p>
  </block>
  <block name="bsui/tabs-panel" value="pricing">
    <p>Pricing content.</p>
  </block>
</block>

Le balisage reste ainsi lisible, tandis que l’API Interactivity gère l’état et le comportement.

Exemples d’applications

L’espace de noms app/* contient des exemples construits à partir des mêmes composants UI.

Ce n’est pas un framework distinct, mais des implémentations de référence pour des interfaces Blockstudio plus riches : blocs composés, UI imbriqués, état Interactivity API, et intégration des composants UI avec RPC ou des fonctionnalités reposant sur une base de données.

HTML
<block name="app/kitchen-sink"></block>

<block name="app/chat">
  <block name="app/chat-sidebar"></block>
  <block name="app/chat-header"></block>
  <block name="app/chat-messages"></block>
  <block name="app/chat-input"></block>
</block>

La bibliothèque UI comprend également sa propre documentation et une référence interactive des composants. Leur comportement ne se résume pas à un ensemble de modèles : il fait partie du contrat du framework et reste cohérent à mesure que la bibliothèque s’étoffe.

Création et modification

Plusieurs changements facilitent la création et la modification des blocs.

Éditeur étendu

La modification de blocs complexes dans la barre latérale de l’inspecteur peut vite devenir difficile. C’est particulièrement vrai pour les champs répétables, les champs de code, le texte enrichi et les groupes imbriqués.

Blockstudio 7.3 ajoute une action d’édition étendue à l’inspecteur de blocs. Elle ouvre un panneau plus large depuis le côté droit de l’éditeur et y affiche les mêmes champs Blockstudio.

L’essentiel, c’est qu’il s’agit toujours du même système de champs. Le rendu des champs n’est pas dupliqué, un second chemin de persistance n’est pas introduit et les changements effectués dans l’éditeur étendu mettent à jour le bloc sélectionné, comme ceux effectués dans la barre latérale habituelle.

Utilisez-le lorsque la barre latérale permet de parcourir les champs, mais qu’elle est trop étroite pour y saisir des données.

Sélecteurs de ressources ciblés

Blockstudio prenait déjà en charge %selector% pour les champs de code. Dans la version 7.3, les ressources CSS et SCSS des blocs peuvent utiliser la même méthode de création.

Dans un fichier CSS, %selector% se développe en la classe ciblée du bloc :

CSS
%selector% {
  --hero-gap: var(--wp--preset--spacing--space-10);
}

%selector%.hero {
  border-bottom: 1px solid currentColor;
}

.hero__title {
  color: red;
}

Cela permet de styliser le véritable élément conteneur :

PHP
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
  <h1 class="hero__title">Hero</h1>
</section>

Les sélecteurs classiques dans *.scoped.css ciblent toujours les éléments descendants. %selector% est le hook explicite pour la racine du bloc.

Dépendances d’extensions

Les blocs peuvent désormais déclarer leurs dépendances à des extensions WordPress dans la clé blockstudio de block.json.

La forme simple vérifie que chaque identifiant d’extension indiqué est actif :

JSON
{
  "blockstudio": {
    "pluginDependencies": ["woocommerce"]
  }
}

La forme objet ajoute des contraintes de version :

JSON
{
  "blockstudio": {
    "pluginDependencies": {
      "woocommerce": {
        "version": ">6"
      }
    }
  }
}

Les identifiants sont les identifiants d’extension WordPress, conformes au système de dépendances d’extensions du noyau WordPress. Blockstudio associe les extensions actives à ces identifiants et ignore l’enregistrement si une extension requise est absente, inactive ou d’une version inférieure à celle requise.

La contrainte de version utilise le même modèle de comparaison que PHP et son version_compare(). Une version simple comme "6" est interprétée comme >=6.

C’est utile pour les blocs qui n’ont de sens que si une extension est disponible : cartes de produits WooCommerce, intégrations de formulaires, intégrations SEO, composants d’adhésion, modules de réservation ou UI d’administration liés à une extension tierce.

Règles de l’éditeur

Le fichier blockstudio.json devient également plus utile en tant que fichier de règles de l’éditeur à l’échelle du projet.

La version 7.3 ajoute une couche de règles blockEditor reposant sur PHP pour les réglages WordPress déjà exposés par des hooks côté serveur. Vous pouvez ainsi définir le comportement global des outils d’insertion, des compositions et des médias sans ajouter de code de liaison ponctuel au thème.

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "blockEditor": {
    "blocks": {
      "allow": ["core/*", "my-theme/*"],
      "deny": ["core/embed", "core/freeform"],
      "directory": false,
      "categories": {
        "rename": {
          "text": "Writing",
          "design": "Layout"
        },
        "order": ["my-theme", "text", "media"]
      }
    },
    "patterns": {
      "core": false,
      "remote": false,
      "categories": {
        "deny": ["gallery"],
        "order": ["featured", "buttons"]
      }
    },
    "media": {
      "openverse": false,
      "imageSizes": {
        "allow": ["thumbnail", "large"]
      }
    }
  }
}

La première version s’en tient volontairement aux fonctionnalités prises en charge par PHP : blocs autorisés et refusés, chargement du répertoire de blocs, libellés et ordre des catégories de l’outil d’insertion, sources et catégories de compositions, Openverse, choix de taille d’image, visibilité des widgets hérités et suppression des styles de bloc enregistrés avec PHP.

Elle ne cherche pas à réécrire les valeurs par défaut arbitraires des blocs du noyau. Des réglages comme core/columns.isStackedOnMobile sont définis dans le flux d’enregistrement JavaScript de l’éditeur de blocs et nécessitent donc un API distinct et plus explicite, au lieu de faire comme s’ils pouvaient être définis dans un fichier JSON.

Alias de balises de bloc

Les balises de bloc disposent désormais d’un filtre d’alias :

PHP
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
    $aliases['theme-button'] = 'bsui/button';
    return $aliases;
});

Un projet peut ainsi définir des balises pratiques pour la création, tout en les faisant correspondre en interne au nom canonique du bloc.

HTML
<bs:theme-button label="Continue" />

C’est particulièrement utile pour composer des modèles riches en UI, lorsque les noms canoniques des blocs sont exacts, mais pas toujours les plus pratiques à utiliser pour la création.

Outils et fiabilité

L’analyse statique, la fiabilité et les outils de performance ont tous progressé.

Analyse statique et documentation générée

L’extension PHPStan prend désormais en charge la définition explicite des racines d’analyse des bibliothèques de blocs externes. Un projet peut ainsi valider les balises <bs:*> et <block> par rapport à des blocs situés en dehors de l’extension ou du thème actuel, tout en réservant ces racines au registre pour l’analyse.

Les vérifications de schéma ont également été étendues aux métadonnées de page et à pluginDependencies, ce qui facilite la détection des configurations de publication invalides avant qu’elles n’atteignent WordPress.

La génération de documentation comprend désormais des références de filtres pour les réglages et les hooks PHP. C’est d’autant plus utile que blockstudio.json devient un véritable fichier de règles de projet, au lieu de se limiter à quelques options éparses.

Fiabilité des pages et de l’éditeur

La version 7.3 comprend également plusieurs correctifs concernant les pages à partir de fichiers, le rendu de l’éditeur et le mode de réinitialisation.

L’analyse des pages basées sur des fichiers gère désormais les mappages de conteneurs personnalisés tenant compte des attributs lors de l’analyse HTML. Les balises de page bs: résolvent également correctement les espaces de noms de blocs avec traits d’union, de sorte que des noms comme custom-theme/card ne perturbent plus l’analyseur.

Les balises de conteneur génériques non natives produisent désormais un innerContent valide lorsqu’elles ne fournissent pas de balisage d’enveloppe. Le contenu de page synchronisé est ainsi plus prévisible et la sérialisation des blocs WordPress reste valide.

L’éditeur a reçu plusieurs correctifs concernant l’aperçu et le préchargement :

  • Tailwind l’éditeur CSS inclut désormais les candidats de classe des modèles de page basés sur des fichiers.
  • Les préchargements de l’éditeur préservent les classes d’enveloppe RichText pour les blocs répétés du même type.
  • Les préchargements de l’éditeur reconnaissent les blocs dont les valeurs de champ par défaut sont développées par Gutenberg, mais omises du balisage de bloc enregistré.
  • Les attributs par défaut enregistrés et développés par Gutenberg sont ignorés avant la comparaison des clés du cache de rendu.
  • Les rendus d’aperçu de l’éditeur et de l’inséreur conservent désormais des entrées de cache distinctes, même lorsqu’ils partagent un identifiant client.
  • bs_get_group() fonctionne désormais correctement avec des groupes de champs personnalisés réutilisés, y compris ceux dont l’identifiant correspond au nom du champ personnalisé, et n’extrait que les préfixes exacts du groupe.
  • Les champs de lien avec withCreateSuggestion configurent correctement le parcours de création LinkControl WordPress et créent des pages brouillon via REST API.
  • Les modèles de bloc PHP ne s’exécutent désormais qu’une fois par rendu, sans inclure au préalable un contenu qui serait ensuite écarté.

Le mode de réinitialisation a également été renforcé. Il neutralise désormais les règles de largeur et de marge verticale des blocs de l’éditeur Gutenberg pour les types de publication configurés, supprime au besoin les styles de contenu et de réinitialisation de l’iframe WordPress et améliore les superpositions de survol et de sélection de Blockstudio.

La couverture des régressions pour les modèles InnerBlocks complexes a également été étendue aux blocs Blockstudio imbriqués. Le parcours de rendu de l’éditeur est ainsi vérifié pour les cas d’insertion de modèles les plus difficiles à repérer manuellement.

Outils de performance

Les sondes blockstudio-perf=1 locales et anonymes peuvent désormais émettre des en-têtes Server-Timing sans injecter le panneau de débogage.

Les mesures couvrent également davantage d’étapes du cycle de compilation : découverte, traitement des ressources, enregistrement et substitutions. Il est ainsi plus facile de voir où le temps est réellement passé sans activer une UI de profilage visible.

Pourquoi cette version est importante

Le thème principal de la version 7.3 est la composition.

Les composants UI facilitent la composition des interfaces d’application. Expanded Editor facilite la modification de blocs plus volumineux. Les dépendances de plug-in permettent aux blocs de décrire le contexte de plug-in dont ils ont besoin. Les règles de l’éditeur déplacent les règles du projet concernant l’éditeur de blocs dans blockstudio.json. Les alias de balises de bloc simplifient la création de modèles. Les correctifs de l’analyseur, de PHPStan et de l’éditeur rendent ces compositions plus fiables lorsqu’elles passent par WordPress.

Blockstudio reste basé sur des fichiers. Les blocs restent des dossiers. Les modèles font toujours le travail. Mais le framework dispose désormais d’une couche UI plus solide, bâtie sur ces fondations.