Ресурси
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(), щоб переглянути визначення зареєстрованих полів.