Dennis · 19. mája 2026
Blockstudio 7.3
Blockstudio 7.3 pridáva do frameworku novú vrstvu: opakovane použiteľné komponenty UI, ktoré možno vykresliť ako akýkoľvek iný blok.
Kým verzia 7.1 zmenila bloky na aplikácie s plným zásobníkom a verzia 7.2 uľahčila kontrolu, validáciu a distribúciu väčších projektov, verzia 7.3 sa zameriava na každodennú prácu pri tvorbe a úpravách týchto aplikácií.
Stručne:
- Komponenty UI: zoskupená knižnica komponentov
bsui/*s voliteľným zapojením, poháňaná rozhraním WordPress Interactivity API. - Aplikácie: zoskupené príklady
app/*, ktoré ukazujú, ako sa komponenty UI skladajú do väčších rozhraní. - Rozšírený editor: širší vysúvací panel na úpravu polí Blockstudio, keď je bočný panel príliš stiesnený.
- Selektory prostriedkov s obmedzeným rozsahom: prostriedky CSS a SCSS môžu používať
%selector%na zacielenie priamo na obalovú triedu bloku. - Závislosti doplnkov: bloky môžu vyžadovať aktívne doplnky WordPress s voliteľnými obmedzeniami verzií.
- Pravidlá editora:
blockstudio.jsonmôže pomocou hákov editora založených na PHP WordPress konfigurovať globálne bloky, vzory a správanie médií. - Aliasy značiek blokov: vlastné aliasy na tvorbu značiek blokov.
- Statická analýza a dokumentácia: lepšie pokrytie PHPStan pre externé knižnice blokov a generovaná dokumentácia nastavení a hákov.
- Opravy stránok a editora: spoľahlivejšie spracovanie stránok založených na súboroch, rozpoznávanie kandidátov Tailwind, režim resetovania, izolácia vyrovnávacej pamäte vykresľovania a prednačítanie editora.
Knižnica UI
Verzia 7.3 obsahuje zoskupenú knižnicu komponentov a ukážkové aplikácie, ktoré ju využívajú.
Komponenty UI
Blockstudio 7.3 obsahuje zoskupenú knižnicu UI v mennom priestore bsui/*.
Komponenty sú bežné bloky Blockstudio, takže ich možno vykresliť v
šablónach, stránkach založených na súboroch, vzoroch aj obsahu príspevkov pomocou rovnakej syntaxe značiek blokov,
ktorú už používate.
Knižnica komponentov UI je v beta verzii, kým získavame ďalšie pripomienky. Cieľom verzie 7.3 je sprístupniť prvú sadu komponentov, poučiť sa zo skutočných projektov a vyladiť názvy, správanie a predvolené nastavenia predtým, než označíme rozhranie API za stabilné.
Knižnica sa používa na základe vlastného rozhodnutia:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Po jej zapnutí možno jednoduché komponenty vykresliť priamo:
<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>
Funguje aj kratšia syntax bs::
<bs:bsui-button label="Save" variant="default" />
Cieľom nie je zmeniť Blockstudio na súpravu UI na tvorbu stránok. Cieľom je sprístupniť bežné základné prvky rozhrania ako bloky, aby aplikácie vytvorené pomocou Blockstudio nemuseli v každom projekte znova vytvárať tlačidlá, dialógové okná, karty, výberové polia, polia formulárov, ponuky, panely nástrojov a komponenty spätnej väzby.
Prvá sada komponentov zahŕňa základné prvky rozloženia, akcií, vstupov, prekryvných vrstiev, navigácie, spätnej väzby, formulárov a zobrazovania údajov:
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
Mnohé z nich sú zložené bloky. Blok bsui/tabs spravuje interaktívny
stav, zatiaľ čo podriadené bloky, ako bsui/tabs-list, bsui/tabs-trigger a
bsui/tabs-panel, opisujú štruktúru.
<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>
Vďaka tomu zostáva značkovanie čitateľné a stav aj správanie spravuje rozhranie Interactivity API.
Príklady aplikácií
Menný priestor app/* obsahuje príklady vytvorené z rovnakých komponentov UI.
Nie sú samostatným frameworkom. Sú referenčnými implementáciami väčších rozhraní Blockstudio: zložených blokov, vnorených UI, stavu API Interactivity a miest, kde sa komponenty UI spájajú s funkciami RPC alebo databáz.
<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>
Knižnica UI obsahuje aj vlastnú dokumentáciu a živú referenciu komponentov. Správanie komponentov netvorí iba súbor šablón. Je súčasťou zmluvy frameworku a zostáva konzistentné aj s rastom knižnice.
Tvorba a úpravy
Niekoľko zmien uľahčuje tvorbu a úpravy blokov.
Rozšírený editor
Pri úpravách zložitých blokov v bočnom paneli inšpektora môže rýchlo chýbať miesto. Platí to najmä pre opakovače, polia kódu, formátovaný text a vnorené skupiny.
Blockstudio 7.3 pridáva do inšpektora bloku akciu rozšíreného editora. Otvorí širší panel vysúvaný z pravej strany editora a zobrazí tie isté polia Blockstudio.
Dôležité je, že stále ide o ten istý systém polí. Vykresľovanie polí sa neduplikuje a nepridáva sa druhý spôsob ukladania. Zmeny vykonané v rozšírenom editore aktualizujú vybraný blok rovnako ako zmeny v bežnom bočnom paneli.
Použite ho, keď bočný panel stačí na prezeranie, ale na zadávanie údajov je príliš stiesnený.
Selektory prostriedkov s obmedzeným rozsahom
Blockstudio už podporoval %selector% pre polia kódu. Vo verzii 7.3 môžu blokové prostriedky CSS
a SCSS používať rovnaký spôsob tvorby.
V súbore CSS sa %selector% rozbalí na triedu bloku s obmedzeným rozsahom:
%selector% {
--hero-gap: var(--wp--preset--spacing--space-10);
}
%selector%.hero {
border-bottom: 1px solid currentColor;
}
.hero__title {
color: red;
}
Vďaka tomu možno upraviť štýl skutočného obaľujúceho prvku:
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
<h1 class="hero__title">Hero</h1>
</section>
Bežné selektory v *.scoped.css naďalej zacieľujú na potomkov. %selector% je
výslovný hák pre koreňový prvok bloku.
Závislosti doplnkov
Bloky teraz môžu deklarovať závislosti WordPress od doplnkov v rámci kľúča blockstudio
rozhrania block.json.
Jednoduchá forma overuje, či je každý uvedený identifikátor doplnku aktívny:
{
"blockstudio": {
"pluginDependencies": ["woocommerce"]
}
}
Objektová forma pridáva obmedzenia verzií:
{
"blockstudio": {
"pluginDependencies": {
"woocommerce": {
"version": ">6"
}
}
}
}
Ide o identifikátory doplnkov WordPress, ktoré zodpovedajú systému závislostí doplnkov jadra WordPress. Blockstudio priradí aktívne doplnky k týmto identifikátorom a vynechá registráciu, ak požadovaný doplnok chýba, nie je aktívny alebo má nižšiu než požadovanú verziu.
Obmedzenie verzie používa rovnaký spôsob porovnávania ako PHP version_compare(). Bežná verzia, napríklad "6", sa považuje za >=6.
Je to užitočné pri blokoch, ktoré majú zmysel iba vtedy, keď je k dispozícii doplnok: produktové karty WooCommerce, integrácie formulárov, integrácie SEO, členské komponenty, rezervačné widgety alebo prvky administrácie UI naviazané na doplnok tretej strany.
Pravidlá editora
Súbor blockstudio.json sa stáva užitočnejším aj ako súbor pravidiel editora na úrovni projektu.
Verzia 7.3 pridáva vrstvu pravidiel blockEditor založenú na PHP pre nastavenia WordPress,
ktoré už poskytuje prostredníctvom hákov na strane servera. Môžete tak definovať globálne správanie nástroja na vkladanie blokov, vzorov a médií bez dodatočného účelového kódu v téme.
{
"$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"]
}
}
}
}
Prvá fáza sa zámerne obmedzuje na možnosti podporované PHP: povolené a zakázané bloky, načítavanie adresára blokov, názvy a poradie kategórií nástroja na vkladanie blokov, zdroje a kategórie vzorov, Openverse, možnosti veľkostí obrázkov, viditeľnosť zastaraných widgetov a odstraňovanie štýlov blokov registrovaných pomocou PHP.
Nesnaží sa prepísať ľubovoľné predvolené nastavenia základných blokov. Nastavenia ako
core/columns.isStackedOnMobile sa spravujú v registračnom postupe JavaScript editora blokov,
preto si vyžadujú samostatné, explicitnejšie API, namiesto toho, aby sa
predstieralo, že patria do súboru JSON.
Alias názvov blokov
Pre značky blokov pribudol filter aliasov:
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
$aliases['theme-button'] = 'bsui/button';
return $aliases;
});
Projekt tak môže definovať značky vhodné na tvorbu obsahu, ktoré sa interne stále mapujú na kanonický názov bloku.
<bs:theme-button label="Continue" />
Je to obzvlášť užitočné pri skladaní šablón náročných na UI, kde sú kanonické názvy blokov správne, ale nie vždy najpríjemnejšie na používanie pri tvorbe obsahu.
Nástroje a spoľahlivosť
Pokročila statická analýza, spoľahlivosť aj nástroje na meranie výkonu.
Statická analýza a generovaná dokumentácia
Rozšírenie PHPStan teraz podporuje explicitné koreňové adresáre externých knižníc blokov na skenovanie. Projekt tak môže overovať značky <bs:*> a <block> voči blokom mimo aktuálneho pluginu alebo témy, pričom tieto adresáre sa pri analýze používajú iba v registri.
Kontroly schémy boli rozšírené aj o metadáta stránok a pluginDependencies, takže neplatnú konfiguráciu pri vydaní možno ľahšie zachytiť ešte predtým, ako sa dostane do WordPress.
Generovanie dokumentácie teraz zahŕňa aj referencie na filtre pre nastavenia a hooky PHP. Je to čoraz dôležitejšie, keď sa blockstudio.json stáva skutočným súborom projektových pravidiel namiesto niekoľkých roztrúsených prepínačov.
Spoľahlivosť stránok a editora
Verzia 7.3 obsahuje aj viacero opráv týkajúcich sa stránok založených na súboroch, vykresľovania editora a režimu resetovania.
Analýza stránok založených na súboroch teraz pri parsovaní HTML správne spracúva vlastné mapovania kontajnerov zohľadňujúce atribúty. Značky stránok bs: tiež správne rozpoznávajú názvové priestory blokov s pomlčkami, takže názvy ako custom-theme/card už parser nezmätú.
Všeobecné značky kontajnerov, ktoré nepatria do jadra, teraz serializujú platný kód innerContent, ak neposkytujú obalové značky. Vďaka tomu je synchronizovaný obsah stránok predvídateľnejší a serializácia blokov WordPress zostáva platná.
V editore pribudlo viacero opráv týkajúcich sa ukážok a prednačítania:
- Tailwind editor CSS teraz zahŕňa kandidátov tried zo šablón stránok založených na súboroch.
- Prednačítanie Editora zachováva triedy obalov RichText pre opakované bloky rovnakého typu.
- Prednačítanie Editora zodpovedá blokom, ktorých predvolené hodnoty polí rozšíri Gutenberg, no v uloženej značke bloku chýbajú.
- Registrované predvolené atribúty rozšírené pomocou Gutenberg sa pred porovnaním kľúčov vyrovnávacej pamäte vykreslenia ignorujú.
- Náhľady vykreslenia Editora a vkladacieho nástroja teraz používajú samostatné položky vyrovnávacej pamäte, aj keď zdieľajú ID klienta.
bs_get_group()teraz správne funguje pri opätovne použitých skupinách vlastných polí vrátane skupín, ktorých ID sa zhoduje s názvom vlastného poľa, a extrahuje iba presné predpony skupín.- Polia odkazov s
withCreateSuggestionteraz správne prepájajú proces vytvárania v LinkControl WordPress a vytvárajú koncepty stránok prostredníctvom REST API. - Šablóny blokov PHP sa teraz vykonajú raz pri každom vykreslení namiesto spustenia zahodeného predbežného vloženia.
Vylepšený bol aj režim resetovania. Teraz neutralizuje pravidlá šírky blokov a zvislých okrajov editora Gutenberg pre nakonfigurované typy príspevkov, v prípade potreby odstraňuje štýly obsahu a resetovania prvku WordPress iframe a vylepšuje prekrytia pri umiestnení kurzora a výbere v Blockstudio.
Testy regresií pre zložité vzory InnerBlocks boli rozšírené aj o vnorené bloky Blockstudio, aby sa vykresľovanie v editore overilo aj v prípadoch vkladania vzorov, ktoré sa najťažšie kontrolujú manuálne.
Nástroje na meranie výkonu
Lokálne anonymné sondy blockstudio-perf=1 teraz môžu odosielať hlavičky Server-Timing bez vkladania panela ladenia.
Časové merania teraz pokrývajú väčšiu časť procesu zostavovania: vyhľadávanie, spracovanie zdrojov, registráciu a prepísania. Ľahšie tak zistíte, kde sa čas skutočne míňa, bez zapnutia viditeľného panela UI na profilovanie.
Prečo je toto vydanie dôležité
Hlavnou témou verzie 7.3 je skladanie.
Komponenty UI uľahčujú skladanie rozhraní aplikácií. Rozšírený Editor uľahčuje úpravu väčších blokov. Závislosti pluginov umožňujú blokom uviesť, aký kontext pluginu potrebujú. Pravidlá editora presúvajú pravidlá editora blokov na úrovni projektu do blockstudio.json. Aliasy značiek blokov spríjemňujú tvorbu šablón.
Opravy parsera, PHPStan a editora zvyšujú spoľahlivosť týchto zostáv pri prechode cez WordPress.
Blockstudio je stále založený na súboroch. Bloky sú stále priečinky. Šablóny stále odvádzajú svoju prácu. Framework však teraz nad týmto základom ponúka robustnejšiu vrstvu UI.