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

Ресурсы поля кода

Помимо статических стилей и скриптов в виде файлов, Blockstudio также поддерживает динамические блоки ресурсов через поле кода. В зависимости от задачи их можно ограничить областью действия блока.

Основы использования

Для простейшего случая можно вручную вывести содержимое поля кода в шаблоне.

PHP

PHP
<div useBlockProps>
  <h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>

Twig

Twig
<div useBlockProps>
  <h1>My block</h1>
</div>
<style>{{ attributes.css }}</style>

Селектор с ограниченной областью действия

Чтобы избежать конфликтов с другими блоками, можно использовать переменную %selector% в поле кода вместе с useBlockProps в шаблоне вывода.

В полях кода %selector% указывает на отдельный экземпляр блока. В файлах CSS и SCSS %selector% указывает на общий класс блока с ограниченной областью действия.

Пример

Представим, что в поле кода нужно выбрать тег h1 из приведенного выше примера.

CSS
%selector% h1 {
  color: red;
}

Теперь Blockstudio выполнит три действия:

  • Создаст уникальный идентификатор экземпляра блока
  • Заменит %selector% уникальным идентификатором
  • Добавит такой же селектор к элементу с отметкой useBlockProps

Итоговый результат будет выглядеть примерно так:

HTML
<div data-assets="c9abe0d95c2b">
  <h1>My block</h1>
</div>
<style>
  [data-assets='c9abe0d95c2b'] h1 {
    color: red;
  }
</style>

Автоматический вывод

Постоянно вручную выводить тег style может быть неудобно. Чтобы упростить этот процесс, можно использовать атрибут asset в поле кода.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "code",
        "id": "code",
        "label": "Custom CSS",
        "language": "css",
        "asset": true
      }
    ]
  }
}

Это автоматически создаст теги style для блоков кода, помеченных как css, и переместит их в head документа. Для полей, где в качестве языка указано javascript, вместо них будут созданы теги script и размещены в конце body.

В расширениях

При использовании полей кода внутри расширений атрибут asset не нужен. Blockstudio автоматически выведет содержимое поля кода как ресурс, если указан язык css или javascript.

Пример

JSON
{
  "$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.

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "type": "code",
        "id": "styles",
        "label": "Styles",
        "language": "scss",
        "asset": true
      }
    ]
  }
}

Такие возможности SCSS, как переменные, вложенность и миксины, тоже работают:

Scss
%selector% {
  $primary: #3b82f6;

  h1 {
    color: $primary;
  }

  &:hover {
    background: lighten($primary, 40%);
  }
}

В редакторе SCSS компилируется на сервере в реальном времени, поэтому результат виден по мере ввода. На сайте компиляция выполняется при рендеринге блока.