Dennis · 2026. május 19.
Blockstudio 7.3
A Blockstudio 7.3 új réteggel bővíti a keretrendszert: újrafelhasználható UI komponensekkel, amelyek bármely más blokkhoz hasonlóan jeleníthetők meg.
A 7.1 a blokkokat teljes stacket lefedő alkalmazásokká alakította, a 7.2 pedig megkönnyítette a nagyobb projektek áttekintését, ellenőrzését és terjesztését. A 7.3 a mindennapi fejlesztés és szerkesztés élményére összpontosít.
Röviden:
- UI komponensek: beépített, igény szerint bekapcsolható
bsui/*komponenskönyvtár, amelyet a WordPress Interactivity API működtet. - Alkalmazások: beépített
app/*példák, amelyek bemutatják, hogyan állnak össze a UI komponensek nagyobb felületekké. - Kibővített szerkesztő: szélesebb oldalsó panel a Blockstudio mezők szerkesztéséhez, ha az oldalsáv túl szűkös.
- Hatókörhöz kötött eszközválasztók: a CSS és SCSS eszközök a
%selector%használatával közvetlenül célozhatják a blokk burkolóelemének osztályát. - Bővítményfüggőségek: a blokkok aktív WordPress bővítményeket követelhetnek meg, opcionális verziókorlátozásokkal.
- Szerkesztői szabályzatok: a
blockstudio.jsonglobális blokkokat, mintákat és médiaviselkedést állíthat be a WordPress PHP-alapú szerkesztői hookjaival. - Blokkcímke-aliászok: egyéni aliászok a blokkcímkék írásához.
- Statikus elemzés és dokumentáció: jobb PHPStan-lefedettség külső blokkkönyvtárakhoz, valamint generált dokumentáció a beállításokhoz és hookokhoz.
- Oldal- és szerkesztői javítások: megbízhatóbb fájlalapú oldalelemzés, Tailwind-jelöltek felismerése, visszaállítási mód, elkülönített renderelési gyorsítótár és szerkesztői előtöltések.
UI-könyvtár
A 7.3 beépített komponenskönyvtárral és az arra épülő példaalmazásokkal érkezik.
UI komponensek
A Blockstudio 7.3 beépített UI könyvtárral érkezik a bsui/* névtér alatt. A komponensek hagyományos Blockstudio blokkok, így sablonokban, fájlalapú oldalakon, mintákban és bejegyzéstartalomban is megjeleníthetők az Ön által már használt blokkcímke-szintaxissal.
A UI komponenskönyvtár bétaverzióban van, amíg további visszajelzéseket gyűjtünk. A 7.3 célja, hogy elérhetővé tegye az első komponenskészletet, valós projekteken gyűjtsön tapasztalatokat, és finomítsa az elnevezéseket, a működést és az alapértelmezéseket, mielőtt stabilnak nyilvánítjuk a API felületet.
A könyvtár használata opcionális:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Bekapcsolás után az egyszerű komponensek közvetlenül megjeleníthetők:
<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>
A rövidebb bs: szintaxis is használható:
<bs:bsui-button label="Save" variant="default" />
A cél nem az, hogy a Blockstudio oldalépítő UI készletté váljon. A gyakori felületi alapelemeket szeretnénk blokkokként elérhetővé tenni, hogy a Blockstudio használatával készült alkalmazásoknak ne kelljen minden projektben újra létrehozniuk a gombokat, párbeszédpaneleket, füleket, választókat, űrlapmezőket, menüket, eszköztárakat és visszajelző komponenseket.
Az első komponenskészlet elrendezési, műveleti, beviteli, átfedő, navigációs, visszajelző, űrlap- és adatmegjelenítési alapelemeket tartalmaz:
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
Ezek közül sok összetett blokk. Egy bsui/tabs blokk kezeli az interaktív állapotot, míg a gyermekblokkok, például a bsui/tabs-list, a bsui/tabs-trigger és a bsui/tabs-panel, írják le a szerkezetet.
<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>
Így a jelölőkód olvasható marad, az állapotot és a viselkedést pedig az Interactivity API kezeli.
Alkalmazáspéldák
A app/* névtér a UI komponensekből felépített példákat tartalmaz.
Ezek nem különálló keretrendszert alkotnak, hanem nagyobb Blockstudio felületek referenciamegvalósításai: összetett blokkok, egymásba ágyazott UI, Interactivity API-állapot, valamint olyan helyzetek, ahol a UI komponensek RPC-val vagy adatbázis-alapú funkciókkal találkoznak.
<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>
A UI könyvtár saját dokumentációval és élő komponensreferenciával is rendelkezik. A komponensek viselkedése nem pusztán sablonok gyűjteménye: a keretrendszer szerződésének része, és a könyvtár bővülésével is egységes marad.
Fejlesztés és szerkesztés
Több változtatás is megkönnyíti a blokkok fejlesztését és szerkesztését.
Kibővített szerkesztő
Az összetett blokkok szerkesztésére hamar szűkössé válhat az ellenőri oldalsáv. Ez különösen igaz az ismétlőmezőkre, kódmezőkre, formázott szövegre és egymásba ágyazott csoportokra.
A Blockstudio 7.3 kibővített szerkesztési műveletet ad a blokkellenőrhöz. Ez egy szélesebb, a szerkesztő jobb oldaláról megnyíló panelen jeleníti meg ugyanazokat a Blockstudio mezőket.
A lényeg, hogy továbbra is ugyanazt a mezőrendszert használja. Nem hoz létre ismétlődő mezőmegjelenítést vagy második mentési útvonalat, a kibővített szerkesztőben végzett módosítások pedig ugyanúgy frissítik a kijelölt blokkot, mint a szokásos oldalsávban végzett módosítások.
Akkor használja, ha az oldalsáv áttekintésre megfelel, de az adatok beviteléhez túl szűkös.
Hatókörhöz kötött eszközválasztók
A Blockstudio már támogatta a kódmezőkben használható %selector%-t. A 7.3-ban a blokkok CSS- és SCSS-eszközei ugyanezt a fejlesztési mintát követhetik.
Egy CSS fájlban a %selector% a blokk hatókörhöz kötött osztályára bővül:
%selector% {
--hero-gap: var(--wp--preset--spacing--space-10);
}
%selector%.hero {
border-bottom: 1px solid currentColor;
}
.hero__title {
color: red;
}
Így a tényleges burkolóelem is formázható:
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
<h1 class="hero__title">Hero</h1>
</section>
A *.scoped.css hagyományos választói továbbra is a leszármazott elemeket célozzák. A %selector% kifejezetten a blokk gyökérelemének elérésére szolgál.
Bővítményfüggőségek
A blokkok mostantól aktív WordPress bővítményektől való függőségeket adhatnak meg az block.json blockstudio kulcsában.
Az egyszerű forma ellenőrzi, hogy a felsorolt bővítményazonosítók mindegyike aktív-e:
{
"blockstudio": {
"pluginDependencies": ["woocommerce"]
}
}
Az objektumforma verziókorlátozásokat is megadhat:
{
"blockstudio": {
"pluginDependencies": {
"woocommerce": {
"version": ">6"
}
}
}
}
Az azonosítók WordPress bővítményazonosítók, amelyek megfelelnek a WordPress alapvető bővítményfüggőségi rendszerének. A Blockstudio ezekre az azonosítókra oldja fel az aktív bővítményeket, és kihagyja a regisztrációt, ha egy szükséges bővítmény hiányzik, inaktív vagy verziója nem éri el a megkövetelt értéket.
A verziókorlátozás ugyanazt az összehasonlítási modellt használja, mint a PHP version_compare() rendszere. Egy egyszerű verzió, például a "6", >=6 értékként értelmezendő.
Ez olyan blokkoknál hasznos, amelyek csak egy bővítmény jelenlétében működnek: WooCommerce termékkártyák, űrlapintegrációk, SEO-integrációk, tagsági komponensek, foglalási widgetek vagy külső bővítményhez kötött adminisztrációs UI.
Szerkesztői szabályzatok
A blockstudio.json fájl projekt szintű szerkesztői szabályzatfájlként is egyre hasznosabbá válik.
A 7.3 a PHP-alapú blockEditor szabályzati réteget adja hozzá azokhoz a beállításokhoz, amelyeket a WordPress már szerveroldali hookokon keresztül elérhetővé tesz. Így egyszeri témakódok nélkül állítható be a globális beszúró, a minták és a média viselkedése.
{
"$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"]
}
}
}
}
Az első változat szándékosan azokra a lehetőségekre szorítkozik, amelyeket a PHP támogat: engedélyezett és tiltott blokkok, blokkkönyvtár betöltése, a beszúró kategóriafeliratai és sorrendje, mintaforrások és -kategóriák, Openverse, képméret-választék, régi widgetek láthatósága, valamint a PHP által regisztrált blokkstílusok eltávolítása.
Nem próbálja felülírni a központi blokkok tetszőleges alapértelmezéseit. Az olyan beállítások, mint a core/columns.isStackedOnMobile, a blokkszerkesztő JavaScript regisztrációs folyamatában élnek, ezért külön, egyértelműbb API szükséges hozzájuk; nem szabad úgy tenni, mintha egy JSON fájlban is megadhatók lennének.
Blokkcímke-aliászok
A blokkcímkék alias-szűrőt kaptak:
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
$aliases['theme-button'] = 'bsui/button';
return $aliases;
});
Így a projekt fejlesztőbarát címkéket határozhat meg, amelyek belsőleg továbbra is a kanonikus blokknévre oldódnak fel.
<bs:theme-button label="Continue" />
Ez különösen hasznos UI-elemekkel teli sablonok összeállításakor, ahol a kanonikus blokknevek helyesek, de nem feltétlenül ezek a legkényelmesebbek a fejlesztéshez.
Eszközök és megbízhatóság
A statikus elemzés, a megbízhatóság és a teljesítménymérő eszközök mind fejlődtek.
Statikus elemzés és generált dokumentáció
A PHPStan-bővítmény mostantól támogatja a külső blokkkönyvtárak kifejezett vizsgálati gyökérkönyvtárait. Így a projekt a <bs:*> és <block> címkéket a jelenlegi bővítményen vagy témán kívül található blokkok alapján is ellenőrizheti, miközben az elemzés során ezek a gyökérkönyvtárak csak regiszterként szolgálnak.
A sémaellenőrzés az oldalmetaadatokra és a pluginDependencies-ra is kiterjed, így könnyebb felismerni az érvénytelen, kiadáskor érvénybe lépő konfigurációt, mielőtt az eljutna a WordPress-ig.
A dokumentációgenerálás mostantól a beállításokhoz és a PHP hookokhoz tartozó szűrőreferenciákat is tartalmazza. Ez egyre fontosabb, ahogy a blockstudio.json valódi projekt-szabályzatfájllá válik néhány elszórt kapcsoló helyett.
Oldal- és szerkesztői megbízhatóság
A 7.3 a fájlalapú oldalak, a szerkesztői renderelés és a visszaállítási mód javításait is tartalmazza.
A fájlalapú oldalak elemzése mostantól figyelembe veszi az attribútumokat az egyéni tárolóleképezéseknél HTML elemzésekor. Az bs: oldalcímkék a kötőjeles blokk-névtereket is helyesen oldják fel, így az olyan nevek, mint a custom-theme/card, többé nem zavarják meg az elemzőt.
Az általános, nem törzshöz tartozó tárolócímkék mostantól érvényes innerContent formátumra szerializálódnak, ha nem adnak meg burkolójelölést. Ez kiszámíthatóbbá teszi a szinkronizált oldaltartalmat, és érvényesen tartja az WordPress blokkok szerializálását.
A szerkesztő több javítást kapott az előnézet és az előbetöltés működésével kapcsolatban:
- Az Tailwind szerkesztő CSS mostantól a fájlalapú oldalsablonok osztályjelöltjeit is tartalmazza.
- A szerkesztő előbetöltései megőrzik a RichText burkolóosztályait az azonos típusú ismétlődő blokkoknál.
- A szerkesztő előbetöltései azokat a blokkokat is felismerik, amelyek alapértelmezett mezőértékeit az Gutenberg kibővíti, de a mentett blokkjelölés nem tartalmazza.
- Az Gutenberg által kibővített regisztrált alapértelmezett attribútumokat a renderelési gyorsítótár kulcsainak összehasonlítása előtt figyelmen kívül hagyja.
- A szerkesztő és a beszúró előnézeti renderelése külön gyorsítótár-bejegyzést használ akkor is, ha ugyanaz az ügyfélazonosítójuk.
- Az
bs_get_group()mostantól megfelelően működik újrahasznált egyéni mezőcsoportokkal, beleértve azokat is, amelyek azonosítója megegyezik az egyéni mező nevével; csak a pontos csoport-előtagokat nyeri ki. - Az
withCreateSuggestionattribútummal rendelkező hivatkozásmezők mostantól megfelelően bekötik az WordPress LinkControl létrehozási folyamatát, és piszkozatoldalakat hoznak létre az REST API használatával. - Az PHP blokksablonok renderelésenként egyszer futnak le, elvetett előzetes include futtatása helyett.
A visszaállítási módot is pontosítottuk. Mostantól semlegesíti az Gutenberg szerkesztő blokkszélességre és függőleges margóra vonatkozó szabályait a beállított bejegyzéstípusoknál, szükség esetén eltávolítja az WordPress iframe tartalmi és visszaállítási stílusait, és letisztultabb rámutatási/kijelölési fedvényeket ad az Blockstudio számára.
A komplex InnerBlocks minták regressziós tesztlefedettsége is bővült a beágyazott Blockstudio blokkokkal, így a szerkesztő renderelési útvonala azokat a mintabeillesztési eseteket is ellenőrzi, amelyeket a legnehezebb kézzel észrevenni.
Teljesítményeszközök
A helyi, névtelen blockstudio-perf=1 mérőpontok mostantól Server-Timing fejléceket is kibocsáthatnak a hibakereső panel beszúrása nélkül.
Az időmérések mostantól a build életciklusának több részére is kiterjednek: a felderítésre, az eszközfeldolgozásra, a regisztrációra és a felülbírálásokra. Így könnyebb meglátni, mire megy el ténylegesen az idő, anélkül, hogy látható profilozási UI lenne bekapcsolva.
Miért fontos ez a kiadás
A 7.3 fő témája az összeállíthatóság.
Az UI komponensekkel könnyebb alkalmazásfelületeket összeállítani. A kibővített Editor megkönnyíti a nagyobb blokkok szerkesztését. A bővítményfüggőségek lehetővé teszik, hogy a blokkok megadják, milyen bővítménykörnyezetre van szükségük. A szerkesztői szabályzatok a projekt szintű blokkszerkesztői szabályokat az blockstudio.json helyezi át. A blokkcímke-aliasok kényelmesebbé teszik a sablonok írását. Az elemző, az PHPStan és a szerkesztő javításai megbízhatóbbá teszik ezeket az összeállításokat, amikor végighaladnak az WordPress rendszeren.
Az Blockstudio továbbra is fájlalapú. A blokkok továbbra is mappákban vannak. A munkát továbbra is a sablonok végzik. Erre az alapra azonban most erősebb UI réteg épül.