Ugrás a tartalomhoz

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.json globá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:

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

Bekapcsolás után az egyszerű komponensek közvetlenül megjeleníthetők:

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>

A rövidebb bs: szintaxis is használható:

HTML
<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/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

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.

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>

Í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.

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>

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:

CSS
%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ó:

PHP
<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:

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

Az objektumforma verziókorlátozásokat is megadhat:

JSON
{
  "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.

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

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:

PHP
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.

HTML
<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 withCreateSuggestion attribú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.