Перейти к содержимому

Ресурсы

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(), чтобы просмотреть зарегистрированные определения полей.