Dennis · 19. toukokuuta 2026
Blockstudio 7.3
Blockstudio 7.3 lisää kehykseen uuden kerroksen: uudelleenkäytettäviä UI-komponentteja, jotka voidaan renderöidä kuten mikä tahansa muu lohko.
Versio 7.1 muutti lohkot täyden pinon sovelluksiksi ja 7.2 helpotti suurempien projektien tarkastelua, validointia ja jakelua. Versio 7.3 keskittyy näiden sovellusten rakentamisen ja muokkaamisen päivittäiseen kokemukseen.
Lyhyesti:
- UI-komponentit: mukana toimitettava, valinnaisesti käyttöön otettava
bsui/*-komponenttikirjasto, jonka toimintaa tehostaa WordPressn vuorovaikutteisuus-API. - Sovellukset: mukana toimitettavia
app/*-esimerkkejä, jotka havainnollistavat, miten UI-komponenteista muodostetaan suurempia käyttöliittymiä. - Laajennettu editori: leveämpi sivupaneeli Blockstudio-kenttien muokkaamiseen, kun sivupalkki käy ahtaaksi.
- Rajatut omaisuusvalitsimet: CSS- ja SCSS-omaisuuksissa voidaan käyttää
%selector%-valitsinta suoraan lohkon kääreluokan kohdistamiseen. - Lisäosariippuvuudet: lohkot voivat edellyttää aktiivisia WordPress-lisäosia, ja niille voi määrittää valinnaiset versiorajoitteet.
- Editorin käytännöt:
blockstudio.jsonvoi määrittää yleiset lohkot, kuviot ja median toiminnan kohteen WordPress PHP-pohjaisten editorihookien avulla. - Lohkotunnisteiden aliakset: mukautetut aliakset lohkotunnisteiden kirjoittamiseen.
- Staattinen analyysi ja dokumentaatio: kattavampi PHPStan-tuki ulkoisille lohkokirjastoille sekä automaattisesti luotava dokumentaatio asetuksille ja hookeille.
- Sivu- ja editorikorjaukset: luotettavampi tiedostopohjaisten sivujen jäsennys, Tailwind-ehdokkaiden tunnistus, nollaustila, renderöintivälimuistin eristys ja editorin esilataukset.
UI-kirjasto
Versio 7.3 sisältää komponenttikirjaston ja siihen perustuvia esimerkkisovelluksia.
UI-komponentit
Blockstudio 7.3 sisältää UI-kirjaston nimiavaruudessa bsui/*. Komponentit ovat tavallisia Blockstudio-lohkoja, joten ne voidaan renderöidä mallipohjissa, tiedostopohjaisilla sivuilla, kuvioissa ja artikkelisisällössä samalla lohkotunnistesyntaksilla, jota jo käytät.
UI-komponenttikirjasto on beetavaiheessa, ja keräämme siitä palautetta. Version 7.3 tavoitteena on tuoda ensimmäinen komponenttijoukko saataville, oppia todellisista projekteista ja hioa nimeämistä, toimintaa ja oletuksia ennen kuin API-rajapinta julistetaan vakaaksi.
Kirjaston käyttö on valinnaista:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Kun se on otettu käyttöön, yksinkertaiset komponentit voidaan renderöidä suoraan:
<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>
Myös lyhyempi bs:-syntaksi toimii:
<bs:bsui-button label="Save" variant="default" />
Tavoitteena ei ole tehdä Blockstudiosta sivunrakennustyökalujen UI-kokoelmaa. Tarkoituksena on tarjota yleiset käyttöliittymän perusosat lohkoina, jotta kohteella Blockstudio toteutettujen sovellusten ei tarvitse luoda painikkeita, valintaikkunoita, välilehtiä, valintalistoja, lomakekenttiä, valikoita, työkalurivejä ja palautekomponentteja uudelleen jokaisessa projektissa.
Ensimmäiseen komponenttijoukkoon kuuluu asettelun, toimintojen, syötteiden, peittokuvien, navigoinnin, palautteen, lomakkeiden ja tietojen näyttämisen perusosia:
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
Monet näistä ovat yhdistelmäl ohkoja. bsui/tabs-lohko hallitsee vuorovaikutteista tilaa, kun taas alilohkot, kuten bsui/tabs-list, bsui/tabs-trigger ja bsui/tabs-panel, määrittävät rakenteen.
<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>
Näin merkintäkieli pysyy luettavana, ja Interactivity API huolehtii tilasta ja toiminnasta.
Sovellusesimerkkejä
Nimiavaruus app/* sisältää esimerkkejä, jotka on rakennettu samoista UI-komponenteista.
Ne eivät ole erillinen kehys. Ne ovat viitetoteutuksia suuremmille Blockstudio-käyttöliittymille: yhdistelmälohkoille, sisäkkäisille UI-rakenteille, Interactivity API -tilalle sekä tilanteille, joissa UI-komponentit liittyvät RPC-toimintoihin tai tietokantapohjaisiin ominaisuuksiin.
<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-kirjastoon sisältyy myös sen oma dokumentaatio ja reaaliaikainen komponenttiviite. Komponenttien toiminta ei ole vain mallipohjien kokoelma. Se on osa kehyksen sopimusta, ja kokonaisuus pysyy yhtenäisenä kirjaston kasvaessa.
Sisällön luominen ja muokkaaminen
Useat muutokset helpottavat lohkojen kirjoittamista ja muokkaamista.
Laajennettu editori
Monimutkaisten lohkojen muokkaaminen tarkastimen sivupalkissa käy nopeasti ahtaaksi. Tämä koskee erityisesti toistimia, koodikenttiä, rikastekstiä ja sisäkkäisiä ryhmiä.
Blockstudio 7.3 lisää lohkotarkastimeen laajennetun editorin toiminnon. Se avaa editorin oikealta puolelta leveämmän sivupaneelin, jossa näytetään samat Blockstudio-kentät.
Tärkeintä on, että käytössä on edelleen sama kenttäjärjestelmä. Kenttien renderöintiä ei kahdenneta, uutta tallennuspolkua ei oteta käyttöön, ja laajennetussa editorissa tehdyt muutokset päivittävät valitun lohkon aivan kuten tavallisessa sivupalkissa tehdyt muutokset.
Käytä sitä, kun sivupalkki sopii tarkasteluun mutta on liian ahdas tietojen syöttämiseen.
Rajatut omaisuusvalitsimet
Blockstudio tuki jo koodikenttien %selector%-ominaisuutta. Versiossa 7.3 lohkojen CSS- ja SCSS-omaisuuksissa voidaan käyttää samaa kirjoitusmallia.
CSS-tiedostossa %selector% laajenee lohkon rajatuksi luokaksi:
%selector% {
--hero-gap: var(--wp--preset--spacing--space-10);
}
%selector%.hero {
border-bottom: 1px solid currentColor;
}
.hero__title {
color: red;
}
Näin varsinaisen kääreelementin tyylittely on mahdollista:
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
<h1 class="hero__title">Hero</h1>
</section>
Kohteen *.scoped.css tavalliset valitsimet kohdistuvat edelleen jälkeläiselementteihin. %selector% on nimenomainen hook lohkon juurielementin kohdistamiseen.
Lisäosariippuvuudet
Lohkot voivat nyt ilmoittaa WordPress-lisäosariippuvuuksia kohteen blockstudio-avaimessa kohteessa block.json.
Yksinkertainen muoto tarkistaa, että jokainen lueteltu lisäosan tunniste on aktiivinen:
{
"blockstudio": {
"pluginDependencies": ["woocommerce"]
}
}
Objektimuoto lisää versiorajoitteet:
{
"blockstudio": {
"pluginDependencies": {
"woocommerce": {
"version": ">6"
}
}
}
}
Tunnisteet ovat WordPress-lisäosatunnisteita, jotka vastaavat kohteen WordPress ydinosan lisäosariippuvuusjärjestelmää. Blockstudio selvittää aktiivisten lisäosien tunnisteet ja ohittaa rekisteröinnin, jos vaadittu lisäosa puuttuu, ei ole aktiivinen tai sen versio alittaa vaaditun.
Versiorajoite käyttää samaa vertailumallia kuin kohteen PHP version_compare(). Pelkkä versio, kuten "6", tulkitaan muodoksi >=6.
Tästä on hyötyä lohkoissa, jotka toimivat vain lisäosan ollessa saatavilla: WooCommerce-tuotekorteissa, lomakeintegraatioissa, SEO-integraatioissa, jäsenyyskomponenteissa, varausvimpaimissa tai kolmannen osapuolen lisäosaan sidotuissa hallintanäkymän UI-kohteissa.
Editorin käytännöt
Tiedostosta blockstudio.json on tulossa entistä hyödyllisempi myös projektitason editorin käytäntötiedostona.
Versio 7.3 lisää kohteeseen PHP perustuvan blockEditor-käytäntökerroksen asetuksille WordPress, jotka se tarjoaa jo palvelinpuolen hookien kautta. Näin voit määrittää yleisen lisäysvalikon, kuviot ja median toiminnan lisäämättä kertakäyttöistä teeman liimakoodia.
{
"$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"]
}
}
}
}
Ensimmäinen versio keskittyy tarkoituksella kohteen PHP tukemiin asetuksiin: sallitut ja estetyt lohkot, lohkohakemiston lataus, lisäysvalikon luokkien nimet ja järjestys, kuvioiden lähteet ja luokat, Openverse, kuvakokovaihtoehdot, vanhojen vimpaimien näkyvyys sekä kohteen PHP rekisteröimien lohkotyylien poistaminen.
Tarkoituksena ei ole kirjoittaa uudelleen mielivaltaisia ydinosan lohkojen oletuksia. Kohteen core/columns.isStackedOnMobile kaltaiset asetukset kuuluvat lohkoeditorin JavaScript-rekisteröintiprosessiin, joten ne vaativat erillisen, nimenomaisemman APIn sen sijaan, että ne yritettäisiin väkisin mahduttaa JSON-tiedostoon.
Lohkotunnisteiden aliakset
Lohkotunnisteisiin lisättiin alias-suodatin:
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
$aliases['theme-button'] = 'bsui/button';
return $aliases;
});
Näin projekti voi määrittää kirjoittamista helpottavia tunnisteita, jotka ratkaistaan sisäisesti silti kanoniseksi lohkonimeksi.
<bs:theme-button label="Continue" />
Tämä on erityisen hyödyllistä sommitteltaessa UI-painotteisia mallipohjia, joissa kanoniset lohkonimet ovat oikeita mutta eivät aina kirjoittamisen kannalta miellyttävimpiä.
Työkalut ja luotettavuus
Staattista analyysiä, luotettavuutta ja suorituskykyä tukevat työkalut kehittyivät kaikki.
Staattinen analyysi ja automaattisesti luotu dokumentaatio
PHPStan-laajennus sai tuen ulkoisten lohkokirjastojen nimenomaisille skannauksen juurihakemistoille. Näin projekti voi validoida <bs:*>– ja <block>-tunnisteet lohkoja vasten, vaikka ne olisivat nykyisen lisäosan tai teeman ulkopuolella, ja pitää nämä juurihakemistot analyysia varten vain rekisterissä.
Skeematarkistuksia laajennettiin myös sivujen metatietoihin ja kohteeseen pluginDependencies, joten virheellinen julkaisuvaiheen määritys on helpompi havaita ennen kuin se päätyy kohteeseen WordPress.
Dokumentaation luontiin sisältyy nyt suodatinviitteet asetuksille ja kohteen PHP hookeille. Tämä on entistä tärkeämpää, kun blockstudio.json toimii varsinaisena projektin käytäntötiedostona eikä vain muutaman hajanaisen valitsimen kokoelmana.
Sivujen ja editorin luotettavuus
Versio 7.3 sisältää myös korjauksia tiedostopohjaisiin sivuihin, editorin renderöintiin ja nollaustilaan.
Tiedostopohjainen sivujen jäsennys käsittelee nyt attribuutit huomioivia mukautettuja säilömäärityksiä HTML-jäsennyksen aikana. Myös bs:-sivutunnisteet ratkaisevat nyt yhdysmerkilliset lohkonimiavaruudet oikein, joten esimerkiksi custom-theme/card ei enää sekoita jäsentimen toimintaa.
Yleiset ei-ydinmoduulin säilötunnisteet sarjallistetaan nyt kelvolliseksi innerContent-sisällöksi, kun ne eivät tarjoa kääremarkkia. Näin synkronoitu sivusisältö on ennustettavampaa ja WordPress-lohkojen sarjallistus pysyy kelvollisena.
Muokkain sai useita esikatseluun ja esilataukseen liittyviä korjauksia:
- Tailwind-muokkaimen CSS sisältää nyt luokkamahdollisuudet tiedostopohjaisista sivupohjista.
- Muokkaimen esilataukset säilyttävät RichText-käärinluokat, kun saman tyypin lohkoja toistetaan.
- Muokkaimen esilataukset tunnistavat lohkot, joiden oletuskenttäarvoja laajentaa Gutenberg mutta jotka puuttuvat tallennetusta lohkomerkinnästä.
- Gutenberg laajentamat rekisteröidyt oletusattribuutit ohitetaan ennen renderöinnin välimuistiavainten vertailua.
- Muokkaimen ja lisäysvalitsimen esikatselurenderöinneille säilytetään nyt erilliset välimuistimerkinnät, vaikka niillä olisi sama asiakastunnus.
bs_get_group()toimii nyt oikein uudelleenkäytettyjen mukautettujen kenttäryhmien kanssa, myös kun ryhmän tunnus vastaa mukautetun kentän nimeä, ja poimii vain täsmälliset ryhmien etuliitteet.- Linkkikentät, joissa on
withCreateSuggestion, yhdistävät nyt WordPress LinkControlin luontitoiminnon oikein ja luovat luonnossivut REST API -toiminnon kautta. - PHP-lohkopohjat suoritetaan nyt kerran renderöintiä kohti sen sijaan, että tehtäisiin pois heitettävä esikäsittelysisällytys.
Nollaustilaa tarkennettiin myös. Se neutraloi nyt Gutenberg-muokkaimen lohkojen leveys- ja pystymarginaalisäännöt määritetyille sisältötyypeille, poistaa tarvittaessa WordPress-iframejen sisältö- ja nollaustyylit sekä tekee Blockstudio-hiiri- ja valintapeittokuvista selkeämmät.
Monimutkaisten InnerBlocks-kuvioiden regressiotestausta laajennettiin myös sisällyttämällä siihen sisäkkäiset Blockstudio-lohkot. Näin muokkaimen renderöintipolku tarkistetaan suhteessa kuviin lisäystilanteisiin, joita on vaikeinta havaita käsin.
Suorituskykytyökalut
Paikalliset anonyymit blockstudio-perf=1-mittaukset voivat nyt tuottaa Server-Timing-otsakkeita lisäämättä virheenjäljityspaneelia.
Ajoitukset kattavat nyt suuremman osan koontiprosessista: löydön, resurssien käsittelyn, rekisteröinnin ja yliajot. Näin näet helpommin, mihin aika todella kuluu, ilman että näkyvää profilointi-UI-näkymää tarvitsee ottaa käyttöön.
Miksi tämä julkaisu on tärkeä
Version 7.3 pääteema on koostaminen.
UI-komponenttien avulla sovelluksen käyttöliittymien koostaminen on helpompaa. Laajennettu Editor helpottaa suurempien lohkojen muokkaamista. Lisäosariippuvuuksien avulla lohkot voivat ilmoittaa tarvitsemansa lisäosakontekstin. Muokkaimen käytännöt siirtävät projektitason lohkomuokkaimen säännöt kohteeseen blockstudio.json. Lohkotunnisteiden aliakset tekevät pohjien kirjoittamisesta sujuvampaa. Jäsentimen, PHPStan:n ja muokkaimen korjaukset parantavat näiden koostettujen kokonaisuuksien luotettavuutta niiden kulkiessa kohteen WordPress läpi.
Blockstudio perustuu yhä tiedostoihin. Lohkot ovat edelleen kansioita. Pohjat hoitavat edelleen työn. Nyt tämän perustan päälle on rakennettu vahvempi UI-kerros.