Dennis · 19 май 2026 г.
Blockstudio 7.3
Blockstudio 7.3 добавя нов слой към рамката: компоненти UI за многократна употреба, които могат да се визуализират като всеки друг блок.
Докато версия 7.1 превърна блоковете в приложения с пълен набор от възможности, а 7.2 улесни прегледа, валидирането и разпространението на по-големи проекти, версия 7.3 се съсредоточава върху ежедневната работа по изграждането и редактирането на тези приложения.
Накратко:
- Компоненти UI: включена по избор библиотека от компоненти
bsui/*, задвижвана от WordPress Interactivity API. - Приложения: включени примери
app/*, които показват как компонентите UI се съчетават в по-големи интерфейси. - Разширен редактор: по-широк панел за редактиране на полета Blockstudio, когато страничната лента стане твърде тясна.
- Ограничени селектори на ресурси: ресурсите CSS и SCSS могат да използват
%selector%, за да насочват директно към класа на обвивката на блока. - Зависимости между плъгини: блоковете могат да изискват активни плъгини WordPress, с незадължителни ограничения за версиите.
- Правила за редактора:
blockstudio.jsonможе да конфигурира глобални блокове, шаблони и поведение на медийните файлове чрез куки на редактора, базирани на WordPress PHP. - Псевдоними за етикети на блокове: персонализирани псевдоними за създаване на етикети на блокове.
- Статичен анализ и документация: по-добро покритие на PHPStan за външни библиотеки с блокове, както и генерирана документация за настройки и куки.
- Поправки за страници и редактора: по-надеждно парсване на страници, базирани на файлове, откриване на кандидати Tailwind, режим за нулиране, изолиране на кеша за рендиране и предварително зареждане в редактора.
Библиотека UI
Версия 7.3 включва библиотека с компоненти и примерни приложения, изградени върху нея.
Компоненти UI
Blockstudio 7.3 включва библиотека UI под пространството от имена bsui/*.
Компонентите са обикновени блокове Blockstudio и затова могат да се визуализират в
шаблони, страници, базирани на файлове, шаблони за оформление и съдържание на публикации със същия синтаксис за етикети на блокове, който вече използвате.
Библиотеката от компоненти UI е в бета версия, докато събираме още отзиви. Целта за версия 7.3 е да предоставим първия набор от компоненти, да научим от реални проекти и да усъвършенстваме имената, поведението и настройките по подразбиране, преди да обявим интерфейса API за стабилен.
Библиотеката е незадължителна:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"ui": {
"enabled": true
}
}
След като я активирате, можете да визуализирате прости компоненти директно:
<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>
Работи и по-краткият синтаксис bs::
<bs:bsui-button label="Save" variant="default" />
Целта не е Blockstudio да се превърне в комплект UI за създаване на страници. Целта е често използвани елементи на интерфейса да са налични като блокове, така че приложенията, създадени с Blockstudio, да не трябва да пресъздават бутони, диалогови прозорци, раздели, падащи менюта, полета на формуляри, менюта, ленти с инструменти и компоненти за обратна връзка във всеки проект.
Първият набор компоненти включва основни елементи за оформление, действия, входни данни, наслагвания, навигация, обратна връзка, формуляри и визуализация на данни:
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
Много от тях са съставни блокове. Блокът bsui/tabs управлява интерактивното
състояние, а дъщерни блокове като bsui/tabs-list, bsui/tabs-trigger и
bsui/tabs-panel описват структурата.
<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>
Така маркировката остава лесна за четене, а състоянието и поведението се обработват от Interactivity API.
Примери за приложения
Пространството от имена app/* съдържа примери, изградени със същите компоненти UI.
Те не са отделна рамка. Те са примерни реализации на по-големи интерфейси Blockstudio: съставни блокове, вложени UI, състояние на Interactivity API и места, където компонентите UI се срещат с RPC или функционалности, базирани на база данни.
<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 включва и собствена документация, както и интерактивен справочник за компонентите. Поведението на компонентите не е просто колекция от шаблони. То е част от договора на рамката и остава последователно с разрастването на библиотеката.
Разработка и редактиране
Няколко промени улесняват разработването и редактирането на блокове.
Разширен редактор
Редактирането на сложни блокове в страничната лента на инспектора бързо може да стане неудобно. Това важи особено за повтарящи се полета, полета за код, форматиран текст и вложени групи.
Blockstudio 7.3 добавя действие за разширен редактор към инспектора на блокове. То отваря по-широк панел от дясната страна на редактора и показва същите полета Blockstudio.
Важно е, че това остава същата система от полета. Не дублира визуализацията на полетата и не въвежда втори път за съхранение. Промените в разширения редактор обновяват избрания блок точно както промените в обичайната странична лента.
Използвайте го, когато страничната лента е удобна за преглед, но твърде тясна за въвеждане на данни.
Ограничени селектори на ресурси
Blockstudio вече поддържаше %selector% за полетата за код. Във версия 7.3 ресурсите CSS и SCSS на блоковете могат да използват същия подход при разработката.
Във файл CSS, %selector% се разгръща до ограничен клас на блока:
%selector% {
--hero-gap: var(--wp--preset--spacing--space-10);
}
%selector%.hero {
border-bottom: 1px solid currentColor;
}
.hero__title {
color: red;
}
Така можете да стилизирате самия елемент обвивка:
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
<h1 class="hero__title">Hero</h1>
</section>
Обичайните селектори в *.scoped.css продължават да насочват към дъщерните елементи. %selector% е изричната кука за корена на блока.
Зависимости между плъгини
Блоковете вече могат да декларират зависимости от плъгини WordPress в ключа blockstudio на block.json.
Простият формат проверява дали всеки посочен идентификатор на плъгин е активен:
{
"blockstudio": {
"pluginDependencies": ["woocommerce"]
}
}
Форматът с обект добавя ограничения за версиите:
{
"blockstudio": {
"pluginDependencies": {
"woocommerce": {
"version": ">6"
}
}
}
}
Идентификаторите са идентификатори на плъгини WordPress, съвпадащи със системата за зависимости между плъгини на ядрото WordPress. Blockstudio преобразува активните плъгини до тези идентификатори и пропуска регистрацията, ако задължителен плъгин липсва, е неактивен или е с по-стара от необходимата версия.
Ограничението за версия използва същия модел за сравнение като PHP version_compare(). Обикновена версия като "6" се третира като >=6.
Това е полезно за блокове, които имат смисъл само когато даден плъгин е наличен: продуктови карти WooCommerce, интеграции с формуляри, интеграции SEO, компоненти за членство, джаджи за резервации или администраторски UI, обвързани с плъгин на трета страна.
Правила за редактора
Файлът blockstudio.json също става по-полезен като файл с правила за редактора на ниво проект.
Версия 7.3 добавя слой с правила blockEditor, базиран на PHP, за настройките WordPress, които вече предоставя чрез сървърни куки. Така можете да дефинирате глобално поведение на вмъкващия блокове, шаблоните и медийните файлове, без да включвате еднократен свързващ код в темата.
{
"$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"]
}
}
}
}
Първата версия умишлено се ограничава до неща, поддържани от PHP: разрешени и забранени блокове, зареждане на директорията с блокове, етикети/ред на категориите във вмъкващия блокове, източници и категории на шаблони, Openverse, избор на размери на изображенията, видимост на остарели уиджети и премахване на стилове на блокове, регистрирани чрез PHP.
Този слой не се опитва да променя произволни настройки по подразбиране на основните блокове. Настройки като core/columns.isStackedOnMobile се намират в процеса на регистрация JavaScript на редактора на блокове, затова изискват отделен, по-изричен API, вместо да се добавят насила във файл JSON.
Псевдоними за етикети на блокове
Към етикетите на блокове е добавен филтър за псевдоними:
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
$aliases['theme-button'] = 'bsui/button';
return $aliases;
});
Това позволява на проекта да дефинира удобни за разработка етикети, които вътрешно продължават да разрешават до каноничното име на блока.
<bs:theme-button label="Continue" />
Това е особено полезно при съставяне на шаблони с много UI, където каноничните имена на блоковете са правилни, но не винаги са най-удобният вариант за разработка.
Инструменти и надеждност
Инструментите за статичен анализ, надеждност и производителност също бяха подобрени.
Статичен анализ и генерирана документация
Разширението PHPStan вече поддържа изрично задаване на основни директории за сканиране на външни библиотеки с блокове. Така проектът може да валидира етикетите <bs:*> и <block> спрямо блокове извън текущия плъгин или тема, като тези директории се използват само от регистъра за целите на анализа.
Проверките на схемите бяха разширени и за метаданните на страниците и pluginDependencies, така че невалидната конфигурация по време на пускане е по-лесна за откриване, преди да достигне WordPress.
Генерирането на документация вече включва справочни материали за филтрите за настройките и PHP куки. Това става все по-важно, тъй като blockstudio.json се превръща в реален файл с правила за проекта, а не просто в място за няколко разпръснати превключвателя.
Надеждност на страниците и редактора
Версия 7.3 включва и набор от поправки за страници, базирани на файлове, визуализацията в редактора и режима за нулиране.
Вече се обработват атрибутно ориентирани съпоставяния на персонализирани контейнерни тагове при парсване на HTML от файлове. Таговете на страниците в bs: също вече разрешават правилно пространства от имена на блокове с тирета, така че имена като custom-theme/card вече не объркват парсера.
Общите контейнерни тагове извън ядрото вече се сериализират като валиден innerContent, когато не предоставят обвиващ markup. Така синхронизираното съдържание на страниците става по-предвидимо и сериализацията на блокове в WordPress остава валидна.
Редакторът получи набор от корекции за визуализациите и предварителното зареждане:
- Tailwind редакторът CSS вече включва кандидати за класове от шаблони на страници, базирани на файлове.
- Предварително зареденото съдържание в редактора запазва класовете на обвивката RichText за повтарящи се блокове от един и същи тип.
- Предварително зареденото съдържание в редактора съвпада с блокове, чиито стойности на полетата по подразбиране са разширени от Gutenberg, но са пропуснати от запазената маркировка на блока.
- Регистрираните атрибути по подразбиране, разширени от Gutenberg, се игнорират преди сравняване на ключовете за кеша на визуализирането.
- Визуализациите за предварителен преглед в редактора и вмъквача вече имат отделни записи в кеша, дори когато споделят клиентски идентификатор.
bs_get_group()вече работи коректно с повторно използвани групи от потребителски полета, включително групи, чийто идентификатор съвпада с името на потребителското поле, и извлича само точните префикси на групите.- Полетата за връзки с
withCreateSuggestionвече свързват правилно процеса за създаване на LinkControl WordPress и създават чернови на страници чрез REST API. - Шаблоните на блокове PHP вече се изпълняват веднъж при всяко визуализиране, вместо да стартират излишно предварително включване.
Режимът за нулиране също е подобрен. Вече неутрализира правилата за ширина на блоковете и вертикални отстъпи в редактора на Gutenberg за конфигурираните типове публикации, премахва стиловете за съдържание и нулиране на iframe в WordPress, когато е нужно, и осигурява по-изчистени наслагвания при посочване и избор в Blockstudio.
Обхватът на регресионните проверки за сложни модели с InnerBlocks също беше разширен и вече включва вложени блокове Blockstudio, така че пътят за визуализация в редактора се проверява и при случаите на вмъкване на модели, които най-трудно се забелязват ръчно.
Инструменти за производителност
Локалните анонимни проби blockstudio-perf=1 вече могат да извеждат заглавки Server-Timing, без да добавят панела за отстраняване на грешки.
Времевите измервания вече обхващат и повече етапи от жизнения цикъл на компилацията: откриване, обработка на ресурси, регистрация и замествания. Така по-лесно се вижда къде всъщност отива времето, без да се включва видим панел за профилиране UI.
Защо тази версия е важна
Основната тема на версия 7.3 е композирането.
Компонентите UI улесняват композирането на интерфейси на приложения. Разширеният редактор улеснява редактирането на по-големи блокове. Зависимостите на плъгините позволяват на блоковете да описват контекста на плъгините, който им е необходим. Политиките на редактора преместват правилата за блоковия редактор на ниво проект в blockstudio.json. Псевдонимите на таговете на блокове улесняват създаването на шаблони. Корекциите в парсера, PHPStan и редактора правят тези композиции по-надеждни, когато преминават през WordPress.
Blockstudio все още е базиран на файлове. Блоковете все още са папки. Шаблоните все още вършат работата. Но върху тази основа рамката вече има по-силен слой UI.