
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 title="blockstudio.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 title="style.scoped.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 title="index.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 title="block.json"
{
  "blockstudio": {
    "pluginDependencies": ["woocommerce"]
  }
}
```

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

```json title="block.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 title="blockstudio.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 title="functions.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.
