Dennis · 2026 m. gegužės 19 d.
Blockstudio 7.3
Blockstudio 7.3 versijoje prie sistemos pridedamas naujas sluoksnis: daugkartinio naudojimo UI komponentai, kuriuos galima atvaizduoti kaip bet kurį kitą bloką.
7.1 versijoje blokai tapo viso steko programomis, o 7.2 palengvino didesnių projektų tikrinimą, validavimą ir platinimą. 7.3 daugiausia dėmesio skiria kasdienei šių programų kūrimo ir redagavimo patirčiai.
Trumpai:
- UI komponentai: kartu pateikiama pasirenkama
bsui/*komponentų biblioteka, paremta WordPress sąveikumo API. - Programos: kartu pateikiami
app/*pavyzdžiai, rodantys, kaip UI komponentai sudaro didesnes sąsajas. - Išplėstinė rengyklė: platesnis ištraukiamas skydelis Blockstudio laukams redaguoti, kai šoninė juosta tampa per ankšta.
- Aprėžti išteklių selektoriai: CSS ir SCSS ištekliuose galima naudoti
%selector%, kad būtų galima tiesiogiai pasirinkti bloko apvalkalo klasę. - Papildinių priklausomybės: blokams galima nurodyti privalomus aktyvius WordPress papildinius ir pasirinktinius jų versijos apribojimus.
- Rengyklės taisyklės:
blockstudio.jsongali konfigūruoti visuotinius blokus, šablonus ir medijos veikimą naudodami WordPress PHP pagrįstus rengyklės kabliukus. - Blokų žymų slapyvardžiai: pasirinktiniai slapyvardžiai blokų žymoms kurti.
- Statinė analizė ir dokumentacija: geresnė išorinių blokų bibliotekų PHPStan aprėptis ir sugeneruota nustatymų bei kabliukų dokumentacija.
- Puslapių ir rengyklės pataisos: patikimesnis failais pagrįstų puslapių analizavimas, Tailwind kandidatų aptikimas, atkūrimo režimas, atvaizdavimo talpyklos izoliavimas ir rengyklės išankstinis duomenų įkėlimas.
UI biblioteka
7.3 versijoje pateikiama komponentų biblioteka ir ja pagrįstos pavyzdinės programos.
UI komponentai
Blockstudio 7.3 versijoje kartu pateikiama UI biblioteka, esanti bsui/* vardų srityje. Komponentai yra įprasti Blockstudio blokai, todėl juos galima atvaizduoti šablonuose, failais pagrįstuose puslapiuose, šablonų rinkiniuose ir įrašų turinyje, naudojant tą pačią blokų žymų sintaksę, kurią jau naudojate.
UI komponentų biblioteka yra beta versijos, kol renkame daugiau atsiliepimų. 7.3 versijos tikslas – pateikti pirmąjį komponentų rinkinį, pasimokyti iš tikrų projektų ir patobulinti pavadinimus, veikimą bei numatytąsias reikšmes prieš paskelbiant API sąsają stabilia.
Biblioteka yra pasirenkama:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
Įjungus paprastus komponentus galima atvaizduoti tiesiogiai:
<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>
Veikia ir trumpesnė bs: sintaksė:
<bs:bsui-button label="Save" variant="default" />
Tikslas nėra paversti Blockstudio puslapių kūrimo priemonių UI rinkiniu. Siekiama pateikti įprastus sąsajos elementus kaip blokus, kad naudojant Blockstudio sukurtose programose nereikėtų kiekviename projekte iš naujo kurti mygtukų, dialogų, skirtukų, pasirinkimo laukų, formų laukų, meniu, įrankių juostų ir informacinių komponentų.
Pirmąjį komponentų rinkinį sudaro išdėstymo, veiksmų, įvesties, perdangų, naršymo, informavimo, formų ir duomenų pateikimo elementai:
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
Daugelis jų yra sudėtiniai blokai. Blokas bsui/tabs valdo interaktyvią būseną, o antriniai blokai, pavyzdžiui, bsui/tabs-list, bsui/tabs-trigger ir bsui/tabs-panel, apibrėžia struktūrą.
<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>
Taip žymėjimas išlieka įskaitomas, o būseną ir veikimą valdo sąveikumo API.
Programų pavyzdžiai
Vardų srityje app/* pateikiami pavyzdžiai, sukurti iš tų pačių UI komponentų.
Tai nėra atskira sistema. Tai didesnių Blockstudio sąsajų pavyzdiniai įgyvendinimai: sudėtiniai blokai, įdėtiniai UI, sąveikumo API būsena ir vietos, kur UI komponentai susijungia su RPC arba duomenų bazės funkcijomis.
<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 bibliotekoje taip pat yra dokumentacija ir veikianti komponentų demonstracija. Komponentų veikimas – tai ne vien šablonų rinkinys. Jis yra sistemos sutarties dalis ir išlieka nuoseklus bibliotekai augant.
Kūrimas ir redagavimas
Keli pakeitimai palengvina blokų kūrimą ir redagavimą.
Išplėstinė rengyklė
Sudėtingus blokus greitai tampa ankšta redaguoti tikrinimo priemonės šoninėje juostoje. Tai ypač aktualu kartotuvams, kodo laukams, raiškiajam tekstui ir įdėtinėms grupėms.
Blockstudio 7.3 versijoje prie bloko tikrinimo priemonės pridedamas išplėstinio redagavimo veiksmas. Jis atidaro platesnį ištraukiamą skydelį dešinėje rengyklės pusėje ir jame pateikia tuos pačius Blockstudio laukus.
Svarbiausia, kad naudojama ta pati laukų sistema. Laukų atvaizdavimas nedubliuojamas ir nesukuriamas antras duomenų išsaugojimo būdas. Išplėstinėje rengyklėje atlikti pakeitimai atnaujina pasirinktą bloką taip pat, kaip pakeitimai įprastoje šoninėje juostoje.
Naudokite ją, kai šoninė juosta tinka peržiūrai, bet yra per ankšta duomenims įvesti.
Aprėžti išteklių selektoriai
Blockstudio jau palaikė %selector% kodo laukus. 7.3 versijoje blokų CSS ir SCSS ištekliams galima naudoti tą patį kūrimo būdą.
CSS faile %selector% išplečiamas į aprėžtą bloko klasę:
%selector% {
--hero-gap: var(--wp--preset--spacing--space-10);
}
%selector%.hero {
border-bottom: 1px solid currentColor;
}
.hero__title {
color: red;
}
Taip galima stilizuoti tikrąjį apvalkalo elementą:
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
<h1 class="hero__title">Hero</h1>
</section>
Įprasti selektoriai *.scoped.css faile vis dar taikomi palikuonims. %selector% yra aiškus kabliukas bloko šakniniam elementui.
Papildinių priklausomybės
Dabar blokuose galima nurodyti WordPress papildinių priklausomybes block.json laukelyje blockstudio.
Paprastuoju formatu tikrinama, ar visi išvardyti papildinių identifikatoriai yra aktyvūs:
{
"blockstudio": {
"pluginDependencies": ["woocommerce"]
}
}
Objektų formatu pridedami versijos apribojimai:
{
"blockstudio": {
"pluginDependencies": {
"woocommerce": {
"version": ">6"
}
}
}
}
Identifikatoriai yra WordPress papildinių identifikatoriai, atitinkantys WordPress pagrindinės sistemos papildinių priklausomybių sistemą. Blockstudio aktyvius papildinius susieja su tais identifikatoriais ir praleidžia registraciją, jei privalomo papildinio trūksta, jis neaktyvus arba neatitinka minimalios versijos.
Versijos apribojimui naudojamas toks pat palyginimo modelis kaip PHP version_compare(). Paprasta versija, pavyzdžiui, "6", laikoma >=6.
Tai naudinga blokams, kurie prasmingi tik tada, kai prieinamas papildinys: WooCommerce produktų kortelėms, formų integracijoms, SEO integracijoms, narystės komponentams, rezervavimo valdikliams ar administravimo UI, susietiems su trečiosios šalies papildiniu.
Rengyklės taisyklės
blockstudio.json failas tampa vis naudingesnis kaip projekto lygmens rengyklės taisyklių failas.
7.3 versijoje pridedamas PHP pagrįstas blockEditor taisyklių sluoksnis nustatymams WordPress, kuriuos jau pateikia serverio pusės kabliukai. Taip galima apibrėžti visuotinio įterpimo, šablonų ir medijos veikimą, nepridedant vienkartinio temos pagalbinio kodo.
{
"$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"]
}
}
}
}
Pirmajame etape sąmoningai apsiribojama tuo, ką palaiko PHP: leidžiamais ir draudžiamais blokais, blokų katalogo įkėlimu, įterpimo kategorijų žymomis ir tvarka, šablonų šaltiniais bei kategorijomis, Openverse, vaizdų dydžių pasirinkimais, senųjų valdiklių matomumu ir PHP užregistruotų blokų stilių pašalinimu.
Ši funkcija nebando perrašyti bet kokių pagrindinės sistemos blokų numatytųjų reikšmių. Tokie nustatymai kaip core/columns.isStackedOnMobile priklauso bloko rengyklės JavaScript registravimo srautui, todėl jiems reikia atskiro ir aiškesnio API, o ne apsimetimo, kad juos galima įrašyti į JSON failą.
Blokų žymų slapyvardžiai
Blokų žymoms pridėtas slapyvardžių filtras:
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
$aliases['theme-button'] = 'bsui/button';
return $aliases;
});
Taip projektas gali apibrėžti patogias kūrėjams žymas, kurios viduje vis tiek susiejamos su kanoniniu bloko pavadinimu.
<bs:theme-button label="Continue" />
Tai ypač naudinga kuriant šablonus, kuriuose daug UI: kanoniniai blokų pavadinimai yra teisingi, bet juos ne visada patogu naudoti kuriant.
Įrankiai ir patikimumas
Patobulintos statinės analizės, patikimumo ir našumo priemonės.
Statinė analizė ir sugeneruota dokumentacija
PHPStan plėtinyje pridėta galimybė aiškiai nurodyti išorinių blokų bibliotekų skenavimo šakninius katalogus. Taip projektas gali tikrinti <bs:*> ir <block> žymas pagal blokus, esančius už dabartinio papildinio ar temos ribų, o analizės tikslais tuos katalogus laikyti prieinamais tik per registrą.
Schemos tikrinimas taip pat išplėstas, kad apimtų puslapių metaduomenis ir pluginDependencies, todėl netinkamą leidimo konfigūraciją lengviau aptikti dar prieš jai pasiekiant WordPress.
Dabar generuojant dokumentaciją įtraukiamos nustatymų filtrų nuorodos ir PHP kabliukai. Tai vis svarbiau, nes blockstudio.json tampa tikru projekto taisyklių failu, o ne vien keliomis išsibarsčiusiomis parinktimis.
Puslapių ir rengyklės patikimumas
7.3 versijoje taip pat yra pataisų, susijusių su failais pagrįstais puslapiais, atvaizdavimu rengyklėje ir atkūrimo režimu.
Failais pagrįstas puslapių analizavimas dabar atpažįsta atributus turinčius pasirinktinius konteinerių susiejimus HTML analizavimo metu. bs: puslapių žymos taip pat teisingai atpažįsta brūkšneliu atskirtas blokų vardų sritis, todėl tokie pavadinimai kaip custom-theme/card analizatoriaus nebesutrikdo.
Bendrosios ne pagrindinės konteinerių žymos dabar serializuojamos kaip tinkamas innerContent, jei jose nėra apvalkalo žymėjimo. Taip sinchronizuotas puslapio turinys tampa labiau nuspėjamas, o WordPress blokų serializavimas išlieka tinkamas.
Redaktoriuje ištaisyta keletas peržiūros ir išankstinio įkėlimo veikimo problemų:
- Tailwind redaktorius CSS dabar įtraukia klasių kandidatus iš failais pagrįstų puslapių šablonų.
- Redaktoriaus išankstinio įkėlimo metu išsaugomos RichText apvalkalo klasės pasikartojantiems to paties tipo blokams.
- Redaktoriaus išankstinio įkėlimo metu atpažįstami blokai, kurių numatytosios laukų reikšmės išplečiamos naudojant Gutenberg, bet neįtraukiamos į išsaugotą blokų žymėjimą.
- Prieš lyginant atvaizdavimo talpyklos raktus, nepaisoma registruotų numatytųjų atributų, išplėstų naudojant Gutenberg.
- Redaktoriaus ir įterpiklio peržiūros atvaizdavimo įrašai dabar talpykloje saugomi atskirai, net jei jų kliento ID sutampa.
bs_get_group()dabar tinkamai veikia su pakartotinai naudojamomis pasirinktinių laukų grupėmis, įskaitant grupes, kurių ID sutampa su pasirinktinio lauko pavadinimu, ir ištraukia tik tikslius grupės prefiksus.- Susiejimo laukai su
withCreateSuggestiondabar tinkamai prijungia WordPress LinkControl kūrimo eigą ir sukuria puslapių juodraščius per REST API. - PHP blokų šablonai dabar vykdomi po vieną kartą per atvaizdavimą, užuot įvykdžius atmetamą išankstinio patikrinimo įtraukimą.
Taip pat patobulintas atstatymo režimas. Dabar jis neutralizuoja Gutenberg redaktoriaus blokų pločio ir vertikalių paraščių taisykles sukonfigūruotiems įrašų tipams, prireikus pašalina WordPress iframe turinio ir atstatymo stilius, o Blockstudio užvedimo ir pasirinkimo perdangos tampa aiškesnės.
Taip pat išplėsta sudėtingų InnerBlocks šablonų regresinių testų aprėptis: įtraukti įdėtiniai Blockstudio blokai, kad redaktoriaus atvaizdavimo eiga būtų tikrinama pagal šablonų įterpimo atvejus, kuriuos sunkiausia pastebėti rankiniu būdu.
Našumo įrankiai
Vietiniai anoniminiai blockstudio-perf=1 zondai dabar gali pateikti Server-Timing antraštes neįterpdami derinimo skydelio.
Dabar matuojama ir daugiau kūrimo ciklo etapų: aptikimas, išteklių apdorojimas, registravimas ir pakeitimai. Taip lengviau pamatyti, kur iš tiesų eikvojamas laikas, neįjungiant matomos profiliavimo UI.
Kodėl šis leidimas svarbus
Pagrindinė 7.3 tema – komponavimas.
UI komponentai palengvina programų sąsajų komponavimą. Išplėstas redaktorius palengvina didesnių blokų redagavimą. Papildinių priklausomybės leidžia blokams nurodyti, kokio papildinių konteksto jiems reikia. Redaktoriaus politikos perkelia projektinio lygmens blokų redaktoriaus taisykles į blockstudio.json. Blokų žymų pseudonimai palengvina šablonų kūrimą. Analizatoriaus, PHPStan ir redaktoriaus pataisos užtikrina, kad šie komponavimo sprendimai būtų patikimesni, kai jie perduodami per WordPress.
Blockstudio vis dar pagrįstas failais. Blokai vis dar yra aplankai. Šablonai vis dar atlieka savo darbą. Tačiau dabar ant šio pagrindo sistema turi tvirtesnį UI sluoksnį.