Ресурси на полето за код
Освен статичните стилове и скриптове като файлове, 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 ще направи три неща:
- Ще създаде уникален идентификатор за този екземпляр на блока
- Ще замени
%selector%с уникалния идентификатор - Ще добави същия селектор към елемента, означен с
useBlockProps
Крайният резултат ще изглежда така:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</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 се компилира от сървъра в реално време, така че виждате резултата, докато пишете. На фронтенда компилацията се извършва при визуализиране на блока.