Към съдържанието

Ресурси на полето за код

Освен статичните стилове и скриптове като файлове, 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>

Автоматично визуализиране

Ръчното добавяне на стиловия таг всеки път може да е досадно. За да улесните този процес, можете да използвате атрибута 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 се компилира от сървъра в реално време, така че виждате резултата, докато пишете. На фронтенда компилацията се извършва при визуализиране на блока.