Preskočiť na obsah

Prostriedky poľa kódu

Okrem statických štýlov a skriptov uložených v súboroch podporuje Blockstudio aj dynamické bloky prostriedkov prostredníctvom poľa kódu. Podľa konkrétneho prípadu použitia ich možno obmedziť na daný blok.

Základné použitie

V najjednoduchšom prípade môžete obsah poľa kódu vykresliť ručne vo svojej šablóne.

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>

Selektor obmedzený na blok

Ak sa chcete vyhnúť konfliktom s ostatnými blokmi, v poli kódu môžete použiť premennú %selector% spolu s useBlockProps vo vykresľovacej šablóne.

V poliach kódu selektor %selector% zacieľuje konkrétnu inštanciu bloku. V súboroch CSS a SCSS zacieľuje %selector% zdieľanú triedu bloku obmedzenú na daný blok.

Príklad

Predstavme si, že v poli kódu chceme zacieliť na značku h1 z príkladu vyššie.

CSS
%selector% h1 {
  color: red;
}

Teraz Blockstudio vykoná tri úlohy:

  • Vytvorí jedinečné ID pre danú inštanciu bloku
  • Nahradí %selector% týmto jedinečným ID
  • Pridá rovnaký selektor k prvku označenému pomocou useBlockProps

Výsledok bude vyzerať približne takto:

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

Automatické vykresľovanie

Ručné vykresľovanie značky štýlu môže byť zdĺhavé. Tento proces si môžete zjednodušiť použitím atribútu asset v poli kódu.

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

Automaticky sa vytvoria značky style pre bloky kódu označené ako css a presunú sa do hlavičky dokumentu. Pre polia, v ktorých je ako jazyk označené javascript, sa namiesto toho vytvoria značky script a umiestnia sa na koniec tela dokumentu.

V rozšíreniach

Pri používaní polí kódu v rámci rozšírení nie je atribút asset potrebný. Blockstudio automaticky vykreslí obsah poľa kódu ako zdrojový súbor, ak je jazykom css alebo javascript.

Príklad

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

Nie je potrebná žiadna ďalšia konfigurácia. Uvedené nastavenie zobrazí pole kódu pre každý blok core/* na bočnom paneli a automaticky vykreslí jeho obsah na stránke ako zdrojový súbor.

SCSS

Polia kódu podporujú kompiláciu SCSS. Nastavte jazyk na scss a Blockstudio pred vykreslením hodnotu skompiluje cez ScssPhp ako CSS.

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

Funkcie SCSS, ako sú premenné, vnáranie a mixiny, fungujú:

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

  h1 {
    color: $primary;
  }

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

V editore sa SCSS kompiluje v reálnom čase na serveri, takže výsledok vidíte počas písania. Na frontende prebieha kompilácia pri vykresľovaní bloku.