Към съдържанието

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 за стабилен.

Библиотеката е незадължителна:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "ui": {
    "enabled": true
  }
}

След като я активирате, можете да визуализирате прости компоненти директно:

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>

Работи и по-краткият синтаксис bs::

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

Целта не е Blockstudio да се превърне в комплект UI за създаване на страници. Целта е често използвани елементи на интерфейса да са налични като блокове, така че приложенията, създадени с Blockstudio, да не трябва да пресъздават бутони, диалогови прозорци, раздели, падащи менюта, полета на формуляри, менюта, ленти с инструменти и компоненти за обратна връзка във всеки проект.

Първият набор компоненти включва основни елементи за оформление, действия, входни данни, наслагвания, навигация, обратна връзка, формуляри и визуализация на данни:

  • 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

Много от тях са съставни блокове. Блокът bsui/tabs управлява интерактивното състояние, а дъщерни блокове като bsui/tabs-list, bsui/tabs-trigger и bsui/tabs-panel описват структурата.

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>

Така маркировката остава лесна за четене, а състоянието и поведението се обработват от Interactivity API.

Примери за приложения

Пространството от имена app/* съдържа примери, изградени със същите компоненти UI.

Те не са отделна рамка. Те са примерни реализации на по-големи интерфейси Blockstudio: съставни блокове, вложени UI, състояние на Interactivity API и места, където компонентите UI се срещат с RPC или функционалности, базирани на база данни.

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 включва и собствена документация, както и интерактивен справочник за компонентите. Поведението на компонентите не е просто колекция от шаблони. То е част от договора на рамката и остава последователно с разрастването на библиотеката.

Разработка и редактиране

Няколко промени улесняват разработването и редактирането на блокове.

Разширен редактор

Редактирането на сложни блокове в страничната лента на инспектора бързо може да стане неудобно. Това важи особено за повтарящи се полета, полета за код, форматиран текст и вложени групи.

Blockstudio 7.3 добавя действие за разширен редактор към инспектора на блокове. То отваря по-широк панел от дясната страна на редактора и показва същите полета Blockstudio.

Важно е, че това остава същата система от полета. Не дублира визуализацията на полетата и не въвежда втори път за съхранение. Промените в разширения редактор обновяват избрания блок точно както промените в обичайната странична лента.

Използвайте го, когато страничната лента е удобна за преглед, но твърде тясна за въвеждане на данни.

Ограничени селектори на ресурси

Blockstudio вече поддържаше %selector% за полетата за код. Във версия 7.3 ресурсите CSS и SCSS на блоковете могат да използват същия подход при разработката.

Във файл CSS, %selector% се разгръща до ограничен клас на блока:

CSS
%selector% {
  --hero-gap: var(--wp--preset--spacing--space-10);
}

%selector%.hero {
  border-bottom: 1px solid currentColor;
}

.hero__title {
  color: red;
}

Така можете да стилизирате самия елемент обвивка:

PHP
<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.

Простият формат проверява дали всеки посочен идентификатор на плъгин е активен:

JSON
{
  "blockstudio": {
    "pluginDependencies": ["woocommerce"]
  }
}

Форматът с обект добавя ограничения за версиите:

JSON
{
  "blockstudio": {
    "pluginDependencies": {
      "woocommerce": {
        "version": ">6"
      }
    }
  }
}

Идентификаторите са идентификатори на плъгини WordPress, съвпадащи със системата за зависимости между плъгини на ядрото WordPress. Blockstudio преобразува активните плъгини до тези идентификатори и пропуска регистрацията, ако задължителен плъгин липсва, е неактивен или е с по-стара от необходимата версия.

Ограничението за версия използва същия модел за сравнение като PHP version_compare(). Обикновена версия като "6" се третира като >=6.

Това е полезно за блокове, които имат смисъл само когато даден плъгин е наличен: продуктови карти WooCommerce, интеграции с формуляри, интеграции SEO, компоненти за членство, джаджи за резервации или администраторски UI, обвързани с плъгин на трета страна.

Правила за редактора

Файлът blockstudio.json също става по-полезен като файл с правила за редактора на ниво проект.

Версия 7.3 добавя слой с правила blockEditor, базиран на PHP, за настройките WordPress, които вече предоставя чрез сървърни куки. Така можете да дефинирате глобално поведение на вмъкващия блокове, шаблоните и медийните файлове, без да включвате еднократен свързващ код в темата.

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

Първата версия умишлено се ограничава до неща, поддържани от PHP: разрешени и забранени блокове, зареждане на директорията с блокове, етикети/ред на категориите във вмъкващия блокове, източници и категории на шаблони, Openverse, избор на размери на изображенията, видимост на остарели уиджети и премахване на стилове на блокове, регистрирани чрез PHP.

Този слой не се опитва да променя произволни настройки по подразбиране на основните блокове. Настройки като core/columns.isStackedOnMobile се намират в процеса на регистрация JavaScript на редактора на блокове, затова изискват отделен, по-изричен API, вместо да се добавят насила във файл JSON.

Псевдоними за етикети на блокове

Към етикетите на блокове е добавен филтър за псевдоними:

PHP
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
    $aliases['theme-button'] = 'bsui/button';
    return $aliases;
});

Това позволява на проекта да дефинира удобни за разработка етикети, които вътрешно продължават да разрешават до каноничното име на блока.

HTML
<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.