Ресурси поля коду
Окрім статичних таблиць стилів і скриптів у файлах, Blockstudio також підтримує динамічні блоки ресурсів через поле коду. Залежно від потреб їх можна обмежити областю дії блока.
Основне використання
У найпростішому випадку вміст поля коду можна вручну вивести у шаблоні.
PHP
<div useBlockProps>
<h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>
Twig
<div useBlockProps>
<h1>My block</h1>
</div>
<style>{{ attributes.css }}</style>
Селектор з обмеженою областю дії
Щоб уникнути конфліктів з іншими блоками, у полі коду можна використовувати змінну %selector% разом із СелекторомuseBlockProps у шаблоні рендерингу.
У полях коду %selector% вибирає окремий екземпляр блока. У файлах CSS і SCSS %selector% натомість вибирає спільний клас блока з обмеженою областю дії.
Приклад
Уявімо, що в полі коду потрібно вибрати тег h1 із прикладу вище.
%selector% h1 {
color: red;
}
Тепер Blockstudio виконає три дії:
- Створить унікальний ID для цього екземпляра блока
- Замінить
%selector%унікальним ID - Додасть такий самий селектор до елемента з позначкою
useBlockProps
У результаті отримаємо приблизно такий код:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Автоматичне відображення
Постійно вручну додавати тег style може бути незручно. Щоб спростити цей процес, можна використовувати атрибут asset у полі коду.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Це автоматично створить теги style для блоків коду, позначених як css, і перемістить їх у head документа. Для полів, у яких мовою вказано javascript, натомість буде створено теги script і розміщено їх у кінці body.
У розширеннях
Під час використання полів коду в розширеннях атрибут asset не потрібен. Blockstudio автоматично обробить вміст поля коду як ресурс, якщо мовою вказано css або javascript.
Приклад
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Додаткова конфігурація не потрібна. Наведений вище приклад покаже поле коду для кожного блоку core/* на бічній панелі й автоматично обробить його вміст як ресурс сторінки.
SCSS
Поля коду підтримують компіляцію SCSS. Установіть мову scss, і Blockstudio скомпілює значення за допомогою ScssPhp, перш ніж обробити його як CSS.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
Функції SCSS, як-от змінні, вкладеність і міксини, працюють:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
У редакторі SCSS компілюється на сервері в реальному часі, тож результат видно під час введення. На зовнішній частині сайту компіляція відбувається під час рендерингу блока.