Gå til indhold

Dennis · 19. maj 2026

Blockstudio 7.3

Blockstudio 7.3 tilføjer et nyt lag til frameworket: genanvendelige UI-komponenter, der kan gengives som enhver anden blok.

Hvor 7.1 gjorde blokke til full-stack-applikationer, og 7.2 gjorde større projekter nemmere at inspicere, validere og distribuere, fokuserer 7.3 på den daglige oplevelse med at bygge og redigere disse applikationer.

Kort fortalt:

  • UI-komponenter: Et medfølgende, valgfrit bsui/*-komponentbibliotek, drevet af WordPress Interactivity API.
  • Apps: Medfølgende app/*-eksempler, der viser, hvordan UI-komponenterne sammensættes til større grænseflader.
  • Udvidet editor: En bredere skuffe til redigering af Blockstudio-felter, når sidepanelet bliver for trangt.
  • Afgrænsede asset-selektorer: CSS- og SCSS-assets kan bruge %selector% til at målrette blokkens wrapperklasse direkte.
  • Pluginafhængigheder: Blokke kan kræve aktive WordPress-plugins med valgfrie versionsbegrænsninger.
  • Editorpolitikker: blockstudio.json kan konfigurere globale blokke, mønstre og medieadfærd ved hjælp af editorhooks baseret på WordPresss PHP.
  • Bloktag-aliaser: Brugerdefinerede aliaser til oprettelse af bloktags.
  • Statisk analyse og dokumentation: Bedre PHPStan-dækning for eksterne blokbiblioteker samt genereret dokumentation for indstillinger og hooks.
  • Side- og editorrettelser: Mere pålidelig filbaseret sideparsing, registrering af Tailwind-kandidater, nulstillingstilstand, isolering af rendercache og forhåndsindlæsning i editoren.

UI-bibliotek

7.3 indeholder et komponentbibliotek og eksempelapps, der er bygget på det.

UI-komponenter

Blockstudio 7.3 indeholder et UI-bibliotek under navneområdet bsui/*. Komponenterne er almindelige Blockstudio-blokke, så de kan gengives i skabeloner, filbaserede sider, mønstre og indlægsindhold med den samme block tag-syntaks, som du allerede bruger.

Komponentbiblioteket UI er i betaversion, mens vi indsamler mere feedback. Målet med 7.3 er at gøre det første sæt komponenter tilgængeligt, lære af virkelige projekter og finpudse navngivning, adfærd og standardindstillinger, før vi erklærer API-fladen stabil.

Biblioteket er valgfrit:

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

Når det er aktiveret, kan enkle komponenter gengives direkte:

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>

Den kortere bs:-syntaks virker også:

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

Målet er ikke at gøre Blockstudio til et kit af sidebygger-UI. Målet er at gøre almindelige grænsefladeelementer tilgængelige som blokke, så applikationer bygget med Blockstudio ikke behøver at genskabe knapper, dialoger, faner, valgfelter, formularfelter, menuer, værktøjslinjer og feedbackkomponenter i hvert projekt.

Det første sæt komponenter omfatter grundelementer til layout, handlinger, input, overlays, navigation, feedback, formularer og datavisning:

  • 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

Mange af dem er sammensatte blokke. En bsui/tabs-blok styrer den interaktive tilstand, mens underordnede blokke som bsui/tabs-list, bsui/tabs-trigger og bsui/tabs-panel beskriver strukturen.

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>

Det holder markupen læsbar, mens Interactivity API håndterer tilstand og adfærd.

Eksempelapps

Navneområdet app/* indeholder eksempler bygget af de samme UI-komponenter.

De er ikke et separat framework. De er referenceimplementeringer af større Blockstudio-grænseflader: sammensatte blokke, indlejrede UI, tilstandsdata fra Interactivity API og steder, hvor UI-komponenter møder RPC- eller databasebaserede funktioner.

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>

UI-biblioteket indeholder også sin egen dokumentation og en interaktiv komponentreference. Komponentadfærd er ikke bare en samling skabeloner. Den er en del af frameworkets kontrakt og forbliver sammenhængende, efterhånden som biblioteket vokser.

Udvikling og redigering

Flere ændringer gør det nemmere at udvikle og redigere blokke.

Udvidet editor

Det kan hurtigt blive trangt at redigere komplekse blokke i inspektørens sidepanel. Det gælder især for gentagelser, kodefelter, RTF og indlejrede grupper.

Blockstudio 7.3 tilføjer en handling til udvidet redigering i blokkens inspektør. Den åbner en bredere skuffe fra højre side af editoren og viser de samme Blockstudio-felter dér.

Det vigtige er, at det stadig er det samme feltsystem. Feltvisningen duplikeres ikke, der indføres ikke en ekstra lagringsvej, og ændringer i den udvidede editor opdaterer den valgte blok ligesom ændringer i det almindelige sidepanel.

Brug den, når sidepanelet er fint til at skimme, men for trangt til at indtaste i.

Afgrænsede asset-selektorer

Blockstudio havde allerede %selector%-understøttelse til kodefelter. I 7.3 kan blokassets af typen CSS og SCSS bruge samme udviklingsmønster.

I en CSS-fil udvides %selector% til blokkens afgrænsede klasse:

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

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

.hero__title {
  color: red;
}

Det gør det muligt at style det faktiske wrapper-element:

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

Almindelige selektorer i *.scoped.css rammer stadig underordnede elementer. %selector% er den eksplicitte hook til blokkens rod.

Pluginafhængigheder

Blokke kan nu angive WordPress-pluginafhængigheder i nøglen blockstudio i block.json.

Den enkle form kontrollerer, at alle angivne plugin-slugs er aktive:

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

Objektformen tilføjer versionsbegrænsninger:

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

Identifikatorerne er WordPress-plugin-slugs, som følger WordPresss system til pluginafhængigheder. Blockstudio finder aktive plugins ud fra deres slugs og springer registreringen over, hvis et krævet plugin mangler, er inaktivt eller har en lavere version end krævet.

Versionsbegrænsningen bruger samme sammenligningsmodel som PHPs version_compare(). En almindelig version som "6" behandles som >=6.

Det er nyttigt for blokke, der kun giver mening, når et plugin er tilgængeligt: WooCommerce-produktkort, formularintegrationer, SEO-integrationer, medlemskomponenter, bookingwidgets eller administrations-UI, der er knyttet til et tredjepartsplugin.

Editorpolitikker

Filen blockstudio.json bliver også mere nyttig som en politikfil på projektniveau for editoren.

7.3 tilføjer et PHP-baseret politiklag for blockEditor-indstillinger, som WordPress allerede stiller til rådighed via hooks på serversiden. Det betyder, at du kan definere global adfærd for indsætter, mønstre og medier uden at tilføje engangskode til temaet.

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

Den første version holder sig bevidst til det, der understøttes af PHP: tilladte og afviste blokke, indlæsning af blokmapper, kategorinavne og -rækkefølge i indsætteren, mønsterkilder og -kategorier, Openverse, valg af billedstørrelse, synlighed af ældre widgets og fjernelse af bloktypografier registreret via PHP.

Den forsøger ikke at overskrive vilkårlige standardindstillinger for kerneblokke. Indstillinger som core/columns.isStackedOnMobile hører til i blokkens editor-JavaScript-registreringsforløb og kræver derfor en separat, mere eksplicit API i stedet for at blive presset ind i en fil af typen JSON.

Aliaser til bloktags

Bloktags har fået et aliasfilter:

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

Det lader et projekt definere tags, der er nemme at skrive, samtidig med at de internt stadig slås op til det kanoniske bloknavn.

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

Det er især nyttigt, når man sammensætter skabeloner med mange UI, hvor de kanoniske bloknavne er korrekte, men ikke altid er de mest behagelige at skrive.

Værktøjer og pålidelighed

Der er gjort fremskridt inden for statisk analyse, pålidelighed og værktøjer til ydelse.

Statisk analyse og genereret dokumentation

PHPStan-udvidelsen understøtter nu eksplicitte scanningsrødder for eksterne blokbiblioteker. Et projekt kan dermed validere tags af typen <bs:*> og <block> mod blokke, der ligger uden for det aktuelle plugin eller tema, samtidig med at disse rødder kun bruges af registret til analyse.

Skemakontrollerne er også blevet udvidet med sidemetadata og pluginDependencies, så ugyldig konfiguration ved udgivelse er nemmere at opdage, før den når WordPress.

Dokumentationsgenereringen omfatter nu filterreferencer for indstillinger og PHP-hooks. Det bliver vigtigere, efterhånden som blockstudio.json bliver en reel politikfil for projektet i stedet for blot en håndfuld spredte til/fra-indstillinger.

Pålidelighed for sider og editor

7.3 indeholder også en række rettelser til filbaserede sider, gengivelse i editoren og nulstillingstilstand.

Filbaseret sideparsing håndterer nu attributbevidste tilknytninger af brugerdefinerede containere under HTML-parsing. bs:-sidetags håndterer også bloknavnerum med bindestreger korrekt, så navne som custom-theme/card ikke længere forvirrer parseren.

Generiske container-tags, der ikke er kerne-tags, serialiseres nu som gyldig innerContent, når de ikke leverer wrapper-markup. Det gør synkroniseret sideindhold mere forudsigeligt og sikrer, at WordPress-blokserialiseringen er gyldig.

Editoren har fået en række rettelser af forhåndsvisning og forudindlæsning:

  • Tailwind-editoren CSS omfatter nu klassekandidater fra filbaserede sideskabeloner.
  • Editorens forudindlæsninger bevarer RichText-wrapperklasser for gentagne blokke af samme type.
  • Editorens forudindlæsninger matcher blokke, hvis standardfeltværdier udvides af Gutenberg, men udelades fra den gemte blokmarkup.
  • Registrerede standardattributter, der udvides af Gutenberg, ignoreres, før renderingscachens nøgler sammenlignes.
  • Forhåndsvisninger i editoren og indsætteren bruger nu separate cacheposter, selv når de deler et klient-id.
  • bs_get_group() fungerer nu problemfrit med genbrugte grupper af brugerdefinerede felter, også grupper, hvis id matcher navnet på det brugerdefinerede felt, og udtrækker kun præcise gruppepræfikser.
  • Linkfelter med withCreateSuggestion forbinder nu oprettelsesflowet i WordPress LinkControl korrekt og opretter kladdesider via REST API.
  • PHP-blokskabeloner køres nu én gang pr. rendering i stedet for at køre et kasseret preflight-include.

Nulstillingstilstanden er også blevet strammet op. Den neutraliserer nu editorblokbredde og lodrette margener for konfigurerede indlægstyper i Gutenberg, fjerner indhold og nulstillingsstile i WordPress-iframes efter behov og giver renere overlejringer ved markør og valg i Blockstudio.

Regressionsdækningen af komplekse InnerBlocks-mønstre er også udvidet til at omfatte indlejrede Blockstudio-blokke, så editorens renderingssti kontrolleres mod de mønsterindsættelser, der er sværest at gennemgå manuelt.

Ydelsesværktøjer

Lokale anonyme blockstudio-perf=1-sonder kan nu udsende Server-Timing-headere uden at indsætte fejlfindingspanelet.

Målingerne dækker nu også flere dele af byggeprocessen: registrering, behandling af aktiver, registrering og tilsidesættelser. Det gør det lettere at se, hvor tiden faktisk går, uden at slå en synlig profilerings-UI til.

Hvorfor denne udgivelse er vigtig

Hovedtemaet i 7.3 er komposition.

UI-komponenter gør det lettere at sammensætte brugerflader til applikationer. Expanded Editor gør det lettere at redigere større blokke. Plugin-afhængigheder gør det muligt for blokke at beskrive, hvilken plugin-kontekst de har brug for. Editorpolitikker flytter regler på projektplan for blokeditoren ind i blockstudio.json. Bloktag-aliaser gør det nemmere at skrive skabeloner. Parseren samt rettelserne af PHPStan og editoren gør disse kompositioner mere pålidelige, når de bevæger sig gennem WordPress.

Blockstudio er stadig filbaseret. Blokke er stadig mapper. Skabelonerne udfører stadig arbejdet. Men frameworket har nu et stærkere lag af UI oven på dette fundament.