Przejdź do treści

Zasoby pola kodu

Oprócz statycznych stylów i skryptów zapisanych w plikach Blockstudio obsługuje także dynamiczne bloki zasobów za pomocą pola kodu. W zależności od zastosowania można ograniczyć je do danego bloku.

Podstawowe użycie

W najprostszym przypadku możesz ręcznie wyrenderować zawartość pola kodu w szablonie.

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>

Ograniczony selektor

Aby uniknąć konfliktów z innymi blokami, możesz użyć zmiennej %selector% w polu kodu wraz z useBlockProps w szablonie renderowania.

W polach kodu %selector% wskazuje pojedynczą instancję bloku. W plikach CSS i SCSS %selector% wskazuje zamiast tego współdzieloną klasę z ograniczonym zakresem danego bloku.

Przykład

Załóżmy, że w polu kodu chcemy wskazać tag h1 z powyższego przykładu.

CSS
%selector% h1 {
  color: red;
}

Teraz Blockstudio wykona trzy działania:

  • Utworzy unikalny identyfikator tej instancji bloku
  • Zastąpi %selector% tym unikalnym identyfikatorem
  • Doda ten sam selektor do elementu oznaczonego jako useBlockProps

Wynik końcowy będzie wyglądać mniej więcej tak:

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

Automatyczne renderowanie

Ręczne renderowanie znacznika style za każdym razem może być uciążliwe. Aby uprościć ten proces, możesz użyć atrybutu asset w polu kodu.

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

Spowoduje to automatyczne utworzenie znaczników style dla bloków kodu oznaczonych jako css i przeniesienie ich do sekcji head dokumentu. Dla pól, w których językiem oznaczono javascript, zostaną utworzone znaczniki script i umieszczone na końcu sekcji body.

W rozszerzeniach

W przypadku pól kodu używanych w rozszerzeniach atrybut asset nie jest potrzebny. Blockstudio automatycznie wyrenderuje zawartość pola kodu jako zasób, jeśli językiem jest css lub javascript.

Przykład

JSON
{
  "$schema": "https://blockstudio.dev/schema/extend",
  "name": "core/*",
  "blockstudio": {
    "extend": true,
    "attributes": [
      {
        "id": "customCss",
        "type": "code",
        "label": "Custom css",
        "language": "css"
      }
    ]
  }
}

Nie jest potrzebna żadna dodatkowa konfiguracja. Powyższe ustawienie wyświetli pole kodu dla każdego bloku core/* na pasku bocznym i automatycznie wyrenderuje jego zawartość jako zasób strony.

SCSS

Pola kodu obsługują kompilację SCSS. Ustaw język na scss, a Blockstudio skompiluje wartość za pomocą ScssPhp, zanim wyrenderuje ją jako CSS.

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

Działają wszystkie funkcje SCSS, takie jak zmienne, zagnieżdżanie i miksy:

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

  h1 {
    color: $primary;
  }

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

W edytorze SCSS jest kompilowany po stronie serwera w czasie rzeczywistym, dzięki czemu widzisz wynik podczas pisania. Na stronie kompilacja odbywa się podczas renderowania bloku.