
Blockstudio 7.3 papildina ietvaru ar jaunu slāni: atkārtoti izmantojamiem UI komponentiem, kurus var renderēt tāpat kā jebkuru citu bloku.

Ja 7.1 pārvērta blokus pilna steka lietotnēs un 7.2 atviegloja lielāku projektu pārbaudi, validēšanu un izplatīšanu, tad 7.3 pievēršas šo lietotņu veidošanas un rediģēšanas ikdienas pieredzei.

Īsumā:

- **UI komponenti**: komplektā iekļauta, pēc izvēles lietojama `bsui/*` komponentu bibliotēka, ko darbina WordPress Interactivity API.
- **Lietotnes**: komplektā iekļauti `app/*` piemēri, kas parāda, kā UI komponenti veido lielākas saskarnes.
- **Paplašinātais redaktors**: platāks sānu panelis Blockstudio lauku rediģēšanai, kad sānjosla kļūst pārāk šaura.
- **Ierobežota tvēruma resursu atlasītāji**: CSS un SCSS resursos var izmantot `%selector%`, lai atlasītu bloka aplauzēja klasi.
- **Spraudņu atkarības**: blokiem var būt nepieciešami aktīvi WordPress spraudņi, norādot izvēles versiju ierobežojumus.
- **Redaktora politikas**: `blockstudio.json` var konfigurēt globālos blokus, rakstus un multivides darbību, izmantojot redaktora āķus, ko nodrošina WordPress PHP.
- **Bloku tagu aizstājvārdi**: pielāgoti aizstājvārdi bloku tagu veidošanai.
- **Statiskā analīze un dokumentācija**: plašāks PHPStan atbalsts ārējām bloku bibliotēkām, kā arī ģenerēta dokumentācija par iestatījumiem un āķiem.
- **Lapu un redaktora labojumi**: uzticamāka failos balstīta lapu parsēšana, Tailwind kandidātu noteikšana, atiestatīšanas režīms, renderēšanas kešatmiņas nodalīšana un redaktora iepriekšēja ielāde.

## UI bibliotēka

Versijā 7.3 ir komplektā iekļauta komponentu bibliotēka un uz tās balstīti lietotņu piemēri.

### UI komponenti

Blockstudio 7.3 komplektā ir iekļauta UI bibliotēka `bsui/*` nosaukumtelpā. Šie komponenti ir parasti Blockstudio bloki, tāpēc tos var renderēt veidnēs, failos balstītās lapās, rakstos un ierakstu saturā, izmantojot to pašu bloku tagu sintaksi, ko jau lietojat.

UI komponentu bibliotēka ir beta versijā, kamēr apkopojam atsauksmes. Versijas 7.3 mērķis ir nodrošināt pirmo komponentu kopu, uzzināt, kā tā darbojas reālos projektos, un pilnveidot nosaukumus, darbību un noklusējuma iestatījumus, pirms API saskarni atzīst par stabilu.

Bibliotēkas izmantošana nav obligāta:

```json title="blockstudio.json"
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "ui": {
    "enabled": true
  }
}
```

Pēc iespējošanas vienkāršus komponentus var renderēt tieši:

```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>
```

Darbojas arī īsākā `bs:` sintakse:

```html
<bs:bsui-button label="Save" variant="default" />
```

Mērķis nav pārvērst Blockstudio par lapu veidotāja UI komplektu. Mērķis ir padarīt biežāk izmantotos saskarnes pamatelementus pieejamus kā blokus, lai ar Blockstudio veidotās lietotnēs katrā projektā no jauna nebūtu jāveido pogas, dialoglodziņi, cilnes, izvēlnes, veidlapu lauki, izvēlnes, rīkjoslas un atsauksmju komponenti.

Pirmajā komponentu kopā ir iekļauti izkārtojuma, darbību, ievades, pārklājumu, navigācijas, atsauksmju, veidlapu un datu attēlošanas pamatelementi:

- `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`

Daudzi no tiem ir salikti bloki. Bloks `bsui/tabs` pārvalda interaktīvo stāvokli, savukārt bērnbloki, piemēram, `bsui/tabs-list`, `bsui/tabs-trigger` un `bsui/tabs-panel`, nosaka struktūru.

```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>
```

Tādējādi marķējums ir pārskatāms, bet stāvokli un darbību pārvalda Interactivity API.

### Lietotņu piemēri

`app/*` nosaukumtelpā ir piemēri, kas veidoti no tiem pašiem UI komponentiem.

Tās nav atsevišķs ietvars. Tie ir paraugi lielākām Blockstudio saskarnēm: saliktiem blokiem, ligzdotiem UI, Interactivity API stāvoklim un vietām, kur UI komponenti mijiedarbojas ar RPC vai datu bāzē balstītām funkcijām.

```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>
```

UI bibliotēkā ir arī pašas dokumentācija un komponentu tiešsaistes uzziņu lapa. Komponentu darbība nav tikai veidņu kopums. Tā ir ietvara līguma daļa, kas saglabā saskaņotību, bibliotēkai augot.

## Izstrāde un rediģēšana

Vairāki uzlabojumi atvieglo bloku izstrādi un rediģēšanu.

### Paplašinātais redaktors

Sarežģītu bloku rediģēšanai inspektora sānjoslā ātri var pietrūkt vietas. Tas īpaši attiecas uz atkārtotājiem, koda laukiem, formatētu tekstu un ligzdotām grupām.

Blockstudio 7.3 bloka inspektoram pievieno paplašinātā redaktora darbību. Tā atver platāku paneli redaktora labajā pusē un tajā attēlo tos pašus Blockstudio laukus.

Svarīgi, ka šeit joprojām tiek izmantota tā pati lauku sistēma. Lauku attēlojums netiek dublēts, netiek ieviests otrs datu saglabāšanas ceļš, un paplašinātajā redaktorā veiktās izmaiņas atjaunina atlasīto bloku tāpat kā parastajā sānjoslā veiktās.

Izmantojiet to, ja sānjosla ir ērta pārskatīšanai, bet pārāk šaura datu ievadei.

### Ierobežota tvēruma resursu atlasītāji

Blockstudio jau atbalstīja `%selector%` koda laukiem. Versijā 7.3 bloku CSS un SCSS resursos var izmantot to pašu izstrādes pieeju.

CSS failā `%selector%` tiek izvērsts par bloka tvērumā ierobežoto klasi:

```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;
}
```

Tas ļauj veidot stilus faktiskajam aplauzēja elementam:

```php title="index.php"
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
  <h1 class="hero__title">Hero</h1>
</section>
```

Parastie atlasītāji `*.scoped.css` joprojām atlasa pēctečus. `%selector%` ir īpašs āķis bloka saknes elementam.

### Spraudņu atkarības

Tagad blokos var deklarēt WordPress spraudņu atkarības atslēgā `blockstudio`, kas atrodas `block.json`.

Vienkāršajā formā tiek pārbaudīts, vai katrs norādītais spraudņa identifikators ir aktīvs:

```json title="block.json"
{
  "blockstudio": {
    "pluginDependencies": ["woocommerce"]
  }
}
```

Objekta formā var pievienot versiju ierobežojumus:

```json title="block.json"
{
  "blockstudio": {
    "pluginDependencies": {
      "woocommerce": {
        "version": ">6"
      }
    }
  }
}
```

Identifikatori ir WordPress spraudņu identifikatori, kas atbilst WordPress kodola spraudņu atkarību sistēmai. Blockstudio atrisina aktīvos spraudņus līdz šiem identifikatoriem un izlaiž reģistrāciju, ja nepieciešamā spraudņa trūkst, tas nav aktīvs vai tā versija ir zemāka par prasīto.

Versiju ierobežojumā tiek izmantots tāds pats salīdzināšanas modelis kā PHP `version_compare()`. Vienkārša versija, piemēram, `"6"`, tiek uzskatīta par `>=6`.

Tas noder blokiem, kuru darbībai vajadzīgs konkrēts spraudnis: WooCommerce produktu kartītēm, veidlapu integrācijām, SEO integrācijām, dalības komponentiem, rezervāciju logrīkiem vai administrēšanas UI, kas piesaistīti trešās puses spraudnim.

### Redaktora politikas

`blockstudio.json` fails kļūst noderīgāks arī kā projekta līmeņa redaktora politiku fails.

Versijā 7.3 ir pievienots PHP balstīts `blockEditor` politiku slānis iestatījumiem, ko WordPress jau nodrošina ar servera puses āķiem. Tādējādi varat definēt globālu ievietotāja, rakstu un multivides darbību, nepievienojot vienreiz lietojamu tēmas palīgkodu.

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

Pirmā versija apzināti aprobežojas ar iespējām, ko nodrošina PHP: atļautie un liegtie bloki, bloku direktorija ielāde, ievietotāja kategoriju nosaukumi un secība, rakstu avoti un kategorijas, Openverse, attēlu izmēru izvēle, mantoto logrīku redzamība un PHP reģistrētu bloku stilu noņemšana.

Tā nemēģina pārrakstīt patvaļīgus kodola bloku noklusējuma iestatījumus. Tādi iestatījumi kā `core/columns.isStackedOnMobile` ietilpst bloku redaktora JavaScript reģistrācijas plūsmā, tāpēc tiem vajadzīgs atsevišķs un skaidrāk definēts API, nevis izlikšanās, ka tie ietilpst JSON failā.

### Bloku tagu aizstājvārdi

Bloku tagiem pievienots aizstājvārdu filtrs:

```php title="functions.php"
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
    $aliases['theme-button'] = 'bsui/button';
    return $aliases;
});
```

Tas ļauj projektā definēt autoram ērtus tagus, kas iekšēji joprojām tiek atrisināti līdz kanoniskajam bloka nosaukumam.

```html
<bs:theme-button label="Continue" />
```

Tas īpaši noder, veidojot veidnes, kurās ir daudz UI: kanoniskie bloku nosaukumi ir pareizi, taču ne vienmēr ērti lietojami izstrādē.

## Rīki un uzticamība

Turpinājās darbs pie statiskās analīzes, uzticamības un veiktspējas rīkiem.

### Statiskā analīze un ģenerētā dokumentācija

PHPStan paplašinājumā pievienots atbalsts skaidri norādītām ārējo bloku bibliotēku skenēšanas saknes mapēm. Tādējādi projekts var validēt `<bs:*>` un `<block>` tagus pret blokiem, kas atrodas ārpus pašreizējā spraudņa vai tēmas, analīzei izmantojot šīs mapes tikai kā reģistru.

Paplašinātas arī shēmu pārbaudes attiecībā uz lapu metadatiem un `pluginDependencies`, tāpēc nederīgu konfigurāciju ir vieglāk atklāt izlaiduma sagatavošanas laikā, pirms tā nonāk līdz WordPress.

Dokumentācijas ģenerēšanā tagad ir iekļautas iestatījumu un PHP āķu filtru uzziņu lapas. Tas kļūst arvien nozīmīgāk, jo `blockstudio.json` no dažiem izkaisītiem slēdžiem pārtop par īstu projekta politiku failu.

### Lapu un redaktora uzticamība

Versijā 7.3 iekļauti arī vairāki labojumi failos balstītām lapām, redaktora renderēšanai un atiestatīšanas režīmam.

Failu lapu parsēšana tagad atbalsta pielāgotas konteineru kartēšanas, kas ņem vērā atribūtus, HTML parsēšanas laikā. Arī `bs:` lapu tagi tagad pareizi apstrādā defisēm atdalītas bloku nosaukumvietas, tāpēc tādi nosaukumi kā `custom-theme/card` vairs neapmulsina parsētāju.

Vispārīgi konteineru tagi, kas nav kodola tagi, tagad serializē derīgu `innerContent`, ja tiem nav norādīts apvalka marķējums. Tādējādi sinhronizētais lapu saturs ir paredzamāks un WordPress bloku serializācija paliek derīga.

Redaktorā tika veikti vairāki labojumi saistībā ar priekšskatījumu un iepriekšēju ielādi:

- Tailwind redaktors CSS tagad iekļauj klašu kandidātus no failos balstītām lapu veidnēm.
- Redaktora iepriekšējās ielādes saglabā RichText apvalka klases atkārtotiem viena veida blokiem.
- Redaktora iepriekšējās ielādes atrod blokus, kuru noklusējuma lauku vērtības tiek izvērstas ar Gutenberg, bet nav iekļautas saglabātajā bloka marķējumā.
- Reģistrētie noklusējuma atribūti, ko izvērš Gutenberg, tiek ignorēti, pirms tiek salīdzinātas renderēšanas kešatmiņas atslēgas.
- Redaktora un ievietotāja priekšskatījumu renderējumi tagad tiek glabāti atsevišķos kešatmiņas ierakstos, pat ja tiem ir viens klienta ID.
- `bs_get_group()` tagad nevainojami darbojas ar atkārtoti izmantotām pielāgotu lauku grupām, tostarp grupām, kuru ID sakrīt ar pielāgotā lauka nosaukumu, un izgūst tikai precīzus grupas prefiksus.
- Saites lauki ar `withCreateSuggestion` tagad pareizi sasaista WordPress LinkControl izveides plūsmu un izveido melnraksta lapas, izmantojot REST API.
- PHP bloku veidnes tagad tiek izpildītas vienu reizi katrā renderēšanas reizē, nevis veicot atmetamu sākotnējo include.

Atiestatīšanas režīms arī tika pilnveidots. Tagad tas neitralizē Gutenberg redaktora bloku platuma un vertikālās atkāpes noteikumus konfigurētajiem ierakstu tipiem, vajadzības gadījumā noņem WordPress iframe satura un atiestatīšanas stilus, kā arī nodrošina tīrākus Blockstudio uznirstošos un atlases pārklājumus.

Arī regresijas testu pārklājums sarežģītiem InnerBlocks rakstiem tika paplašināts, iekļaujot ligzdotus Blockstudio blokus, lai redaktora renderēšanas ceļu pārbaudītu pret rakstu ievietošanas gadījumiem, kurus manuāli ir visgrūtāk pamanīt.

### Veiktspējas rīki

Vietējās anonīmās `blockstudio-perf=1` zondes tagad var izvadīt `Server-Timing` galvenes, neievietojot atkļūdošanas paneli.

Laika mērījumi tagad aptver arī vairāk būvēšanas cikla posmu: atklāšanu, resursu apstrādi, reģistrēšanu un aizstāšanu. Tādējādi ir vieglāk saprast, kur patiesībā aiziet laiks, neieslēdzot redzamu profilēšanas UI.

## Kāpēc šis laidiens ir svarīgs

7.3 galvenā tēma ir kompozīcija.

UI komponenti atvieglo lietotņu saskarņu veidošanu no daļām. Paplašinātais redaktors atvieglo lielāku bloku rediģēšanu. Spraudņu atkarības ļauj blokiem norādīt, kāds spraudņa konteksts tiem ir nepieciešams. Redaktora politikas pārvieto projektu līmeņa bloku redaktora noteikumus uz `blockstudio.json`. Bloku tagu aizstājvārdi atvieglo veidņu veidošanu. Parsētāja, PHPStan un redaktora labojumi padara šīs kompozīcijas uzticamākas, kad tās tiek apstrādātas WordPress.

Blockstudio joprojām balstās uz failiem. Bloki joprojām ir mapes. Veidnes joprojām paveic galveno darbu. Taču tagad ietvars uz šī pamata nodrošina spēcīgāku UI slāni.
