Ga naar de inhoud

Dennis · 19 mei 2026

Blockstudio 7.3

Blockstudio 7.3 voegt een nieuwe laag toe aan het framework: herbruikbare UI-componenten die net als elk ander blok kunnen worden weergegeven.

Waar versie 7.1 blokken omvormde tot full-stack-applicaties en versie 7.2 grotere projecten eenvoudiger inspecteerbaar, valideerbaar en verspreidbaar maakte, richt versie 7.3 zich op de dagelijkse ervaring van het bouwen en bewerken van die applicaties.

In het kort:

  • Componenten van UI: een gebundelde, optionele componentbibliotheek voor bsui/*, aangedreven door de WordPress-API.
  • Apps: gebundelde app/*-voorbeelden die laten zien hoe de componenten van UI samen grotere interfaces vormen.
  • Uitgebreide editor: een bredere lade voor het bewerken van Blockstudio-velden wanneer de zijbalk te krap wordt.
  • Afgebakende assetselectors: CSS- en SCSS-assets kunnen %selector% gebruiken om de wrapperklasse van het blok rechtstreeks te selecteren.
  • Plug-in-afhankelijkheden: blokken kunnen actieve WordPress-plug-ins vereisen, met optionele versiebeperkingen.
  • Editorbeleid: blockstudio.json kan algemene instellingen voor blokken, patronen en media bepalen via editorhooks op basis van WordPress en PHP.
  • Aliassen voor bloktags: aangepaste aliassen voor het schrijven van bloktags.
  • Statische analyse en documentatie: betere dekking van PHPStan voor externe blokbibliotheken, plus gegenereerde documentatie voor instellingen en hooks.
  • Verbeteringen aan pagina’s en editor: betrouwbaardere verwerking van paginabestanden, detectie van Tailwind-kandidaten, resetmodus, isolatie van de rendercache en vooraf geladen editorgegevens.

Bibliotheek van UI

Versie 7.3 bevat een gebundelde componentbibliotheek en voorbeeldapps die erop zijn gebouwd.

Componenten van UI

Blockstudio 7.3 bevat een gebundelde UI-bibliotheek onder de naamruimte bsui/*. De componenten zijn gewone Blockstudio-blokken en kunnen dus worden weergegeven in templates, paginabestanden, patronen en berichtinhoud met dezelfde syntaxis voor bloktags die u al gebruikt.

De componentbibliotheek van UI is in bèta terwijl we meer feedback verzamelen. Het doel voor versie 7.3 is de eerste set componenten beschikbaar te maken, te leren van echte projecten en naamgeving, gedrag en standaardwaarden te verfijnen voordat we de API-interface stabiel noemen.

De bibliotheek is optioneel:

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

Na inschakeling kunnen eenvoudige componenten rechtstreeks worden weergegeven:

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>

De kortere syntaxis bs: werkt ook:

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

Het doel is niet om van Blockstudio een toolkit voor UI-paginabouwers te maken. Het doel is om veelgebruikte interface-elementen als blokken beschikbaar te maken, zodat applicaties die met Blockstudio zijn gebouwd niet in elk project opnieuw knoppen, dialoogvensters, tabbladen, keuzelijsten, formuliervelden, menu’s, werkbalken en feedbackcomponenten hoeven te maken.

De eerste set componenten bevat basiselementen voor indeling, acties, invoer, overlays, navigatie, feedback, formulieren en gegevensweergave:

  • 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

Veel hiervan zijn samengestelde blokken. Een blok bsui/tabs beheert de interactieve status, terwijl onderliggende blokken zoals bsui/tabs-list, bsui/tabs-trigger en bsui/tabs-panel de structuur beschrijven.

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>

Zo blijft de markup leesbaar, terwijl de API de status en het gedrag afhandelt.

Appvoorbeelden

De naamruimte app/* bevat voorbeelden die met dezelfde UI-componenten zijn gebouwd.

Het is geen afzonderlijk framework, maar een referentie-implementatie voor grotere Blockstudio-interfaces: samengestelde blokken, geneste UI, Interactivity-status van API en situaties waarin UI-componenten worden gecombineerd met RPC- of databasefuncties.

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>

De bibliotheek van UI bevat ook eigen documentatie en een live referentie voor componenten. Het gedrag van componenten is meer dan een verzameling templates. Het maakt deel uit van de afspraken van het framework en blijft samenhangend naarmate de bibliotheek groeit.

Maken en bewerken

Verschillende wijzigingen maken blokken eenvoudiger om te maken en bewerken.

Uitgebreide editor

Complexe blokken bewerken in de inspectiezijbalk kan al snel krap worden. Dat geldt vooral voor herhalers, codevelden, rich text en geneste groepen.

Blockstudio 7.3 voegt een actie voor uitgebreid bewerken toe aan de blokinspectie. Hiermee opent u rechts in de editor een bredere lade waarin dezelfde velden van Blockstudio worden weergegeven.

Belangrijk is dat dit nog steeds hetzelfde veldensysteem is. Velden worden niet dubbel weergegeven en er komt geen tweede opslagroute bij. Wijzigingen in de uitgebreide editor werken het geselecteerde blok bij, net als wijzigingen in de gewone zijbalk.

Gebruik deze functie wanneer de zijbalk geschikt is om velden te bekijken, maar te krap is om er gegevens in te voeren.

Afgebakende assetselectors

Blockstudio ondersteunde al %selector% voor codevelden. In versie 7.3 kunnen blokassets van CSS en SCSS hetzelfde patroon gebruiken.

In een CSS-bestand wordt %selector% uitgebreid naar de afgebakende klasse van het blok:

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

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

.hero__title {
  color: red;
}

Zo kunt u het daadwerkelijke wrapper-element opmaken:

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

Gewone selectors in *.scoped.css richten zich nog steeds op onderliggende elementen. %selector% is de expliciete hook voor de hoofdselector van het blok.

Plug-in-afhankelijkheden

Blokken kunnen nu afhankelijkheden van WordPress-plug-ins declareren in de sleutel blockstudio van block.json.

De eenvoudige vorm controleert of elke opgegeven plug-inslug actief is:

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

Met de objectvorm voegt u versiebeperkingen toe:

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

De identificaties zijn slugs van WordPress-plug-ins, volgens het systeem voor plug-in-afhankelijkheden van WordPress Core. Blockstudio koppelt actieve plug-ins aan die slugs en slaat registratie over als een vereiste plug-in ontbreekt, inactief is of een lagere versie heeft dan vereist.

De versiebeperking gebruikt hetzelfde vergelijkingsmodel als version_compare() van PHP. Een gewone versie zoals "6" wordt behandeld als >=6.

Dit is handig voor blokken die alleen zinvol zijn wanneer een plug-in beschikbaar is: productkaarten van WooCommerce, formulierintegraties, integraties met SEO, lidmaatschapscomponenten, boekingswidgets of beheer-UI die aan een plug-in van derden zijn gekoppeld.

Editorbeleid

Het bestand blockstudio.json wordt ook steeds bruikbaarder als beleidsbestand voor de editor op projectniveau.

Versie 7.3 voegt een beleidslaag toe op basis van PHP en blockEditor voor instellingen die WordPress al via hooks aan de serverzijde beschikbaar maakt. Daarmee kunt u algemeen gedrag instellen voor de blokinvoeger, patronen en media, zonder eenmalige themacode toe te voegen.

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"]
      }
    }
  }
}

De eerste versie beperkt zich bewust tot zaken die door PHP worden ondersteund: toegestane en geweigerde blokken, laden van de blokdirectory, labels en volgorde van categorieën in de invoeger, patroonbronnen en -categorieën, Openverse, afbeeldingsgrootteopties, zichtbaarheid van verouderde widgets en verwijdering van blokstijlen die zijn geregistreerd via PHP.

Deze functie probeert niet willekeurige standaardwaarden van kernblokken te overschrijven. Instellingen zoals core/columns.isStackedOnMobile horen bij de registratieprocedure van JavaScript in de blokeditor. Daarvoor is een afzonderlijkere, explicietere API nodig; ze horen niet kunstmatig in een JSON-bestand.

Aliassen voor bloktags

Er is een aliasfilter voor bloktags toegevoegd:

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

Zo kan een project gebruiksvriendelijke tags definiëren, terwijl intern nog steeds de canonieke bloknaam wordt gebruikt.

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

Dit is vooral handig bij templates met veel UI, waarin de canonieke bloknamen correct zijn, maar minder prettig zijn om mee te schrijven.

Ontwikkelhulpmiddelen en betrouwbaarheid

Statische analyse, betrouwbaarheid en hulpmiddelen voor prestaties zijn allemaal verbeterd.

Statische analyse en gegenereerde documentatie

De extensie PHPStan ondersteunt nu expliciete scanroots voor externe blokbibliotheken. Daardoor kan een project <bs:*>– en <block>-tags valideren aan de hand van blokken buiten de huidige plug-in of het huidige thema, waarbij deze roots alleen voor de analyse aan het register worden toegevoegd.

Ook zijn de schemacontroles uitgebreid met paginametadata en pluginDependencies, zodat ongeldige configuratie tijdens de release eenvoudiger kan worden opgespoord voordat die WordPress bereikt.

De documentatiegenerator bevat nu filterreferenties voor instellingen en hooks van PHP. Dat wordt belangrijker nu blockstudio.json een echt beleidsbestand voor projecten wordt in plaats van alleen een paar verspreide schakelaars.

Betrouwbaarheid van pagina’s en editor

Versie 7.3 bevat ook een aantal oplossingen voor paginabestanden, weergave in de editor en de resetmodus.

Het parseren van pagina’s op basis van bestanden verwerkt nu aangepaste containermappings die rekening houden met attributen tijdens het parseren van HTML. Ook worden paginatags van bs: met koppeltekens in block-namespaces nu correct verwerkt, zodat namen zoals custom-theme/card de parser niet langer in de war brengen.

Generieke containertags die niet tot de core behoren, worden nu omgezet in geldige innerContent wanneer ze geen wrapper-markup bevatten. Daardoor is gesynchroniseerde pagina-inhoud voorspelbaarder en blijft de serialisatie van WordPress-blocks geldig.

De editor heeft een aantal verbeteringen gekregen voor previews en preloadgedrag:

  • De Tailwind-editor CSS bevat nu ook class-kandidaten uit paginatemplates op basis van bestanden.
  • Preloads van de editor behouden RichText-wrapperclasses voor herhaalde blocks van hetzelfde type.
  • Preloads van de editor herkennen blocks waarvan standaard veldwaarden door Gutenberg worden uitgebreid, maar ontbreken in de opgeslagen block-markup.
  • Geregistreerde standaardattributen die door Gutenberg worden uitgebreid, worden genegeerd voordat render-cachekeys worden vergeleken.
  • Previewrenders van de editor en de inserter krijgen nu afzonderlijke cache-items, ook wanneer ze dezelfde client-id delen.
  • bs_get_group() werkt nu goed met hergebruikte aangepaste veldgroepen, ook met groepen waarvan de id overeenkomt met de naam van het aangepaste veld, en haalt alleen exacte groepsprefixen op.
  • Linkvelden met withCreateSuggestion koppelen de aanmaakflow van de WordPress LinkControl nu correct en maken conceptpagina’s aan via de REST API.
  • PHP-blocktemplates worden nu één keer per render uitgevoerd, in plaats van eerst een ongebruikte preflight-include uit te voeren.

Ook de resetmodus is aangescherpt. Voor geconfigureerde posttypes neutraliseert deze nu de breedte en verticale margeregels van editorblocks van Gutenberg, verwijdert deze waar nodig de iframe-inhouds- en resetstijlen van WordPress en zorgt deze voor nettere hover- en selectielagen van Blockstudio.

De regressietests voor complexe InnerBlocks-patronen zijn ook uitgebreid met geneste Blockstudio-blocks. Zo wordt het renderpad van de editor gecontroleerd aan de hand van de gevallen bij patrooninvoeging die handmatig het moeilijkst te zien zijn.

Prestatietools

Lokale anonieme blockstudio-perf=1-probes kunnen nu Server-Timing-headers versturen zonder het debugpaneel toe te voegen.

De metingen bestrijken nu ook meer fasen van het buildproces: ontdekking, assetverwerking, registratie en overrides. Zo ziet u makkelijker waar de tijd daadwerkelijk naartoe gaat, zonder een zichtbare profilerings-UI in te schakelen.

Waarom deze release belangrijk is

Het hoofdthema van 7.3 is compositie.

UI-componenten maken het eenvoudiger om applicatie-interfaces samen te stellen. Met Expanded Editor kunt u grotere blocks makkelijker bewerken. Dankzij pluginafhankelijkheden kunnen blocks aangeven welke plugincontext ze nodig hebben. Met editorbeleid verplaatst u projectbrede regels voor de blockeditor naar blockstudio.json. Aliassen voor blocktags maken het schrijven van templates prettiger. De verbeteringen aan de parser, PHPStan en de editor maken deze composities betrouwbaarder wanneer ze door WordPress gaan.

Blockstudio is nog steeds op bestanden gebaseerd. Blocks zijn nog steeds mappen. Templates doen nog steeds het werk. Maar het framework heeft nu een sterkere UI-laag boven op die basis.