Ресурси
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. Файловите ресурси на Blockstudio, базирани на JavaScript, използват 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(), за да проверите регистрираните дефиниции на полетата.