Перейти до вмісту

Ресурси поля коду

Окрім статичних таблиць стилів і скриптів у файлах, 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 виконає три дії:

  • Створить унікальний ID для цього екземпляра блока
  • Замінить %selector% унікальним ID
  • Додасть такий самий селектор до елемента з позначкою 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 компілюється на сервері в реальному часі, тож результат видно під час введення. На зовнішній частині сайту компіляція відбувається під час рендерингу блока.