Ресурсы
Blockstudio предоставляет конвейер обработки ресурсов для блоков без настройки. Добавьте файлы CSS, SCSS или JavaScript рядом с блоком — они автоматически скомпилируются, минифицируются и подключатся.
- Регистрация ресурсов: правила именования файлов и их подключения
- Обработка: компиляция SCSS, импорты ES-модулей и минификация
- Поле кода: редактирование кода в поле с поддержкой встроенного режима
Просмотр ресурсов блока
bs_block_assets('theme/card') возвращает обнаруженные ресурсы фронтенда и холста редактора для зарегистрированного блока Blockstudio. Вызывайте его после регистрации блока, начиная с init. Неизвестные блоки, блоки без Blockstudio и блоки без ресурсов возвращают []. Вспомогательная функция не отображает блок, не добавляет ресурсы в очередь и не запускает компиляцию.
$assets = bs_block_assets('theme/card');
// Each entry has this shape:
[
'type' => 'style',
'handle' => 'blockstudio-theme-card-style-css',
'url' => '/wp-content/blockstudio/cache/.../style-123.css?ver=123',
'inline' => false,
'scope' => ['frontend', 'editor'],
'html' => '<link ...>',
];
type— этоstyleдля CSS иmoduleдля JavaScript. Файловые ресурсы JavaScript в Blockstudio используют модули ES, включая встроенные скрипты.handle— это стабильный идентификатор ресурса, используемый отрисовщиком Blockstudio и фильтромblockstudio/assets/disable. Его не обязательно добавлять в очередь WordPress.url— это разрешенный URL существующего скомпилированного ресурса, включая его версию, либо исходный URL, если скомпилированного файла нет. Для встроенных ресурсов этоnull.inlineотличает встроенный результат<style>/<script>от внешних файлов.scopeперечисляет контексты, в которых применяется ресурс:frontendиeditorдля общих файлов и только один контекст для файлов представления/редактора.htmlсодержит готовый к использованию тег из стандартного отрисовщика ресурсов. Встроенное содержимое, область действия CSS, слои стилей UI и фильтры отключения во время отрисовки обрабатываются так же, как и в обычном выводе блока.
Отсутствующие, пустые, отключенные и не скомпилированные файлы SCSS не включаются в список. Ресурсы родительского документа панели администратора и редактора блоков, добавленные в очередь через WordPress, исключаются. Список ограничен собственными обнаруженными файлами блока. Это не полный набор зависимостей: вложенные блоки, значения полей кода, дескрипторы, добавленные в очередь через WordPress, импорты модулей CSS, Tailwind и общие среды выполнения UI/Interactivity могут зависеть от отображаемого содержимого. Для полного автономного предварительного просмотра используйте Render::document()Предварительный просмотр. Используйте bs_block_fields(), чтобы просмотреть зарегистрированные определения полей.