Ресурсы поля кода
Помимо статических стилей и скриптов в виде файлов, 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>
Автоматический вывод
Постоянно вручную выводить тег 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 компилируется на сервере в реальном времени, поэтому результат виден по мере ввода. На сайте компиляция выполняется при рендеринге блока.