Dennis · 19 mai 2026
Blockstudio 7.3
Blockstudio 7.3 adaugă un nou strat cadrului: componente UI reutilizabile, care pot fi randate ca orice alt bloc.
Dacă versiunea 7.1 a transformat blocurile în aplicații full-stack, iar 7.2 a făcut proiectele mai mari mai ușor de inspectat, validat și distribuit, 7.3 se concentrează pe experiența de zi cu zi a creării și editării acestor aplicații.
Pe scurt:
- Componente UI: o bibliotecă de componente
bsui/*inclusă, opțională, bazată pe WordPress Interactivity API. - Aplicații: exemple
app/*incluse, care arată cum se combină componentele UI în interfețe mai mari. - Editor extins: un panou lateral mai lat pentru editarea câmpurilor Blockstudio când bara laterală devine prea înghesuită.
- Selectori de resurse cu domeniu limitat: resursele CSS și SCSS pot folosi
%selector%pentru a viza direct clasa containerului blocului. - Dependențe de pluginuri: blocurile pot necesita pluginuri WordPress active, cu constrângeri de versiune opționale.
- Politici pentru editor:
blockstudio.jsonpot configura blocuri globale, modele și comportamentul media folosind hookuri pentru editor bazate pe WordPress’ PHP. - Aliasuri pentru etichetele blocurilor: aliasuri personalizate pentru crearea etichetelor blocurilor.
- Analiză statică și documentație: acoperire PHPStan mai bună pentru bibliotecile externe de blocuri, plus documentație generată pentru setări și hookuri.
- Remedieri pentru pagini și editor: analiză mai fiabilă a paginilor bazate pe fișiere, detectarea candidaților Tailwind, modul de resetare, izolarea cache-ului de randare și preîncărcări pentru editor.
Biblioteca UI
Versiunea 7.3 include o bibliotecă de componente și aplicații demonstrative construite pe baza ei.
Componente UI
Blockstudio 7.3 include o bibliotecă UI în spațiul de nume bsui/*. Componentele sunt blocuri Blockstudio obișnuite, așa că pot fi randate în șabloane, pagini bazate pe fișiere, modele și conținutul articolelor, folosind aceeași sintaxă de etichete de bloc pe care o utilizați deja.
Biblioteca de componente UI este în versiune beta, cât timp colectăm mai multe opinii. Obiectivul versiunii 7.3 este să facă disponibil primul set de componente, să învățăm din proiecte reale și să rafinăm denumirile, comportamentul și valorile implicite înainte de a declara stabilă suprafața API.
Biblioteca este opțională:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
După activare, componentele simple pot fi randate direct:
<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>
Funcționează și sintaxa mai scurtă bs::
<bs:bsui-button label="Save" variant="default" />
Scopul nu este să transforme Blockstudio într-un set UI pentru crearea paginilor. Scopul este să ofere primitive comune de interfață sub formă de blocuri, astfel încât aplicațiile create cu Blockstudio să nu fie nevoite să recreeze butoane, ferestre de dialog, file, liste de selecție, câmpuri de formular, meniuri, bare de instrumente și componente pentru feedback în fiecare proiect.
Primul set de componente include primitive pentru aspect, acțiuni, câmpuri de intrare, suprapuneri, navigare, feedback, formulare și afișarea datelor:
bsui/button,bsui/button-group,bsui/toggle,bsui/toggle-group,bsui/toolbarbsui/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-pickerbsui/dialog,bsui/drawer,bsui/popover,bsui/menu,bsui/context-menu,bsui/menubar,bsui/tooltip,bsui/alert-dialogbsui/tabs,bsui/accordion,bsui/breadcrumb,bsui/pagination,bsui/navigation-menubsui/card,bsui/table,bsui/stack,bsui/separator,bsui/aspect-ratio,bsui/badge,bsui/avatar,bsui/progress,bsui/meter,bsui/skeleton,bsui/spinner,bsui/kbdbsui/form,bsui/field,bsui/field-group,bsui/file-upload,bsui/color-picker,bsui/rating
Multe dintre acestea sunt blocuri compuse. Un bloc bsui/tabs gestionează starea interactivă, în timp ce blocurile copil, precum bsui/tabs-list, bsui/tabs-trigger și bsui/tabs-panel, descriu structura.
<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>
Astfel, marcajul rămâne lizibil, iar starea și comportamentul sunt gestionate de API Interactivity.
Exemple de aplicații
Spațiul de nume app/* conține exemple construite din aceleași componente UI.
Acestea nu sunt un cadru separat. Sunt implementări de referință pentru interfețe Blockstudio mai mari: blocuri compuse, UI imbricate, stare Interactivity API și zone în care componentele UI se întâlnesc cu funcționalități RPC sau bazate pe baze de date.
<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>
Biblioteca UI include și propria documentație, precum și o referință interactivă a componentelor. Comportamentul componentelor nu este doar o colecție de șabloane. Face parte din contractul cadrului și rămâne coerent pe măsură ce biblioteca crește.
Crearea și editarea
Mai multe modificări facilitează crearea și editarea blocurilor.
Editor extins
Editarea blocurilor complexe în bara laterală de inspecție poate deveni rapid dificilă. Acest lucru este valabil mai ales pentru câmpuri repetabile, câmpuri de cod, text îmbogățit și grupuri imbricate.
Blockstudio 7.3 adaugă o acțiune de editor extins în inspectorul blocului. Aceasta deschide un panou mai lat din partea dreaptă a editorului și afișează acolo aceleași câmpuri Blockstudio.
Important este că sistemul de câmpuri rămâne același. Nu se dublează randarea câmpurilor și nu se introduce o a doua cale de persistență, iar modificările făcute în editorul extins actualizează blocul selectat la fel ca modificările făcute în bara laterală obișnuită.
Folosiți-l când bara laterală este potrivită pentru examinare, dar prea înghesuită pentru introducerea propriu-zisă a datelor.
Selectori de resurse cu domeniu limitat
Blockstudio avea deja suport %selector% pentru câmpurile de cod. În versiunea 7.3, resursele CSS și SCSS ale blocurilor pot folosi același tipar de creare.
Într-un fișier CSS, %selector% se extinde la clasa cu domeniu limitat a blocului:
%selector% {
--hero-gap: var(--wp--preset--spacing--space-10);
}
%selector%.hero {
border-bottom: 1px solid currentColor;
}
.hero__title {
color: red;
}
Astfel, este posibilă stilizarea elementului container propriu-zis:
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
<h1 class="hero__title">Hero</h1>
</section>
Selectorii obișnuiți din *.scoped.css vizează în continuare elementele descendente. %selector% este hookul explicit pentru elementul rădăcină al blocului.
Dependențe de pluginuri
Acum, blocurile pot declara dependențe de pluginuri WordPress în cheia blockstudio din block.json.
Forma simplă verifică dacă fiecare identificator de plugin listat este activ:
{
"blockstudio": {
"pluginDependencies": ["woocommerce"]
}
}
Forma de obiect adaugă constrângeri de versiune:
{
"blockstudio": {
"pluginDependencies": {
"woocommerce": {
"version": ">6"
}
}
}
}
Identificatorii sunt identificatori de plugin WordPress, conform sistemului de dependențe de pluginuri din nucleul WordPress. Blockstudio identifică pluginurile active după acești identificatori și omite înregistrarea dacă un plugin necesar lipsește, este inactiv sau are o versiune mai veche decât cea necesară.
Constrângerea de versiune folosește același model de comparație ca PHP’s version_compare(). O versiune simplă, precum "6", este tratată ca >=6.
Este util pentru blocurile care au sens doar când este disponibil un plugin: carduri de produse WooCommerce, integrări de formulare, integrări SEO, componente de abonament, widgeturi pentru rezervări sau UI de administrare asociate unui plugin terț.
Politici pentru editor
Fișierul blockstudio.json devine tot mai util și ca fișier de politici pentru editor, la nivel de proiect.
Versiunea 7.3 adaugă un strat de politici blockEditor bazat pe PHP pentru setările WordPress deja expuse prin hookuri de pe server. Astfel, puteți defini comportamentul global al inseratorului, al modelelor și al elementelor media fără să livrați cod specific unei singure teme.
{
"$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"]
}
}
}
}
Prima etapă se limitează intenționat la elementele bazate pe PHP: blocuri permise și interzise, încărcarea directorului de blocuri, etichetele/categoriile inseratorului și ordinea lor, sursele și categoriile modelelor, Openverse, opțiunile pentru dimensiunile imaginilor, vizibilitatea widgeturilor vechi și eliminarea stilurilor de blocuri înregistrate prin PHP.
Nu încearcă să rescrie valorile implicite arbitrare ale blocurilor din nucleu. Setări precum core/columns.isStackedOnMobile aparțin fluxului JavaScript de înregistrare al editorului de blocuri, așa că au nevoie de un API separat și mai explicit, în loc să fie incluse forțat într-un fișier JSON.
Aliasuri pentru etichetele blocurilor
Etichetele blocurilor au primit un filtru de alias:
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
$aliases['theme-button'] = 'bsui/button';
return $aliases;
});
Astfel, un proiect poate defini etichete ușor de folosit la creare, care se rezolvă totuși la nivel intern la numele canonic al blocului.
<bs:theme-button label="Continue" />
Este deosebit de util la compunerea șabloanelor complexe UI, unde numele canonice ale blocurilor sunt corecte, dar nu sunt întotdeauna cele mai ușor de folosit la creare.
Instrumente și fiabilitate
Analiza statică, fiabilitatea și instrumentele de performanță au evoluat.
Analiză statică și documentație generată
Extensia PHPStan a adăugat suport pentru rădăcini explicite de scanare a bibliotecilor externe de blocuri. Astfel, un proiect poate valida etichetele <bs:*> și <block> în raport cu blocuri aflate în afara pluginului sau temei curente, păstrând totodată aceste rădăcini doar în registru pentru analiză.
Verificările schemelor au fost extinse și pentru metadatele paginilor și pluginDependencies, astfel încât configurațiile de lansare nevalide să fie mai ușor de detectat înainte să ajungă în WordPress.
Generarea documentației include acum referințe la filtre pentru setări și hookuri PHP. Acest lucru contează mai mult pe măsură ce blockstudio.json devine un fișier real de politici ale proiectului, nu doar un loc cu câteva comutatoare răzlețe.
Fiabilitatea paginilor și a editorului
Versiunea 7.3 include și o serie de remedieri pentru paginile bazate pe fișiere, randarea editorului și modul de resetare.
Analizarea paginilor din fișiere gestionează acum mapările personalizate de containere care țin cont de atribute în timpul analizării HTML. Etichetele de pagină bs: rezolvă corect și spațiile de nume ale blocurilor cu cratimă, astfel încât nume precum custom-theme/card nu mai încurcă analizatorul.
Etichetele generice de container care nu sunt de bază serializează acum innerContent valid atunci când nu furnizează marcaj pentru wrapper. Astfel, conținutul sincronizat al paginilor devine mai previzibil, iar serializarea blocurilor WordPress rămâne validă.
Editorul a primit o serie de remedieri privind comportamentul previzualizărilor și al preîncărcării:
- Tailwind editorul CSS include acum candidați de clase din șabloanele de pagină bazate pe fișiere.
- Preîncărcările editorului păstrează clasele wrapperului RichText pentru blocurile repetate de același tip.
- Preîncărcările editorului identifică blocurile ale căror valori implicite ale câmpurilor sunt extinse de Gutenberg, dar omise din marcajul blocului salvat.
- Atributele implicite înregistrate, extinse de Gutenberg, sunt ignorate înainte de compararea cheilor cache-ului de randare.
- Randările de previzualizare din editor și din instrumentul de inserare păstrează acum intrări separate în cache, chiar și atunci când au același ID de client.
bs_get_group()funcționează acum fără probleme cu grupurile reutilizate de câmpuri personalizate, inclusiv grupurile al căror ID corespunde numelui câmpului personalizat, și extrage doar prefixele exacte ale grupurilor.- Câmpurile Link cu
withCreateSuggestionconectează acum corect fluxul de creare al LinkControl WordPress și creează pagini ciornă prin REST API. - Șabloanele de blocuri PHP se execută acum o singură dată per randare, în loc să ruleze un include preliminar abandonat.
Și modul de resetare a fost rafinat. Acum neutralizează regulile pentru lățimea blocurilor editorului Gutenberg și marginile verticale pentru tipurile de articole configurate, elimină stilurile de conținut/resetare ale iframe-ului WordPress acolo unde este necesar și oferă suprapuneri mai curate la trecerea cursorului/selectare pentru Blockstudio.
Testele de regresie pentru modelele complexe InnerBlocks au fost extinse și pentru a include blocuri Blockstudio imbricate, astfel încât fluxul de randare al editorului este verificat în raport cu cazurile de inserare a modelelor cel mai greu de observat manual.
Instrumente de măsurare a performanței
Sondele locale anonime blockstudio-perf=1 pot emite acum antete Server-Timing fără a injecta panoul de depanare.
Măsurătorile de timp acoperă acum mai multe etape ale procesului de compilare: descoperirea, procesarea resurselor, înregistrarea și suprascrierile. Astfel, este mai ușor să vedeți unde se duce efectiv timpul, fără a activa un panou vizibil de profilare UI.
De ce contează această versiune
Tema principală a versiunii 7.3 este compoziția.
Componentele UI facilitează compunerea interfețelor aplicațiilor. Editorul extins facilitează editarea blocurilor mai mari. Dependențele pluginurilor permit blocurilor să descrie contextul de plugin de care au nevoie. Politicile editorului mută regulile pentru editorul de blocuri la nivel de proiect în blockstudio.json. Aliasurile etichetelor de bloc fac crearea șabloanelor mai plăcută. Remedierile pentru analizator, PHPStan și editor fac aceste compoziții mai fiabile pe parcursul WordPress.
Blockstudio este în continuare bazat pe fișiere. Blocurile sunt tot dosare. Șabloanele continuă să facă treaba. Însă acum cadrul are un nivel UI mai solid construit peste această fundație.