Перейти до вмісту

Ресурси

Blockstudio забезпечує для блоків конвеєр обробки ресурсів без конфігурації. Додайте файли CSS, SCSS або JavaScript поруч із блоком — їх буде автоматично скомпільовано, мінімізовано та додано в чергу.

Перегляд ресурсів блоку

bs_block_assets('theme/card') повертає виявлені ресурси фронтенду та полотна редактора для зареєстрованого блоку Blockstudio. Викликайте його після реєстрації блоку, на init або пізніше. Для невідомих блоків, блоків без Blockstudio і блоків без ресурсів повертається []. Помічник не відображає блок, не додає нічого до черги й не запускає компіляцію.

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