Přejít k obsahu

Prostředky z pole kódu

Kromě statických stylů a skriptů uložených v souborech podporuje Blockstudio také dynamické bloky prostředků prostřednictvím pole kódu. V závislosti na použití je lze omezit na daný blok.

Základní použití

V nejjednodušším případě můžete obsah pole kódu vykreslit ručně v šabloně.

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>

Výběr ohraničený na blok

Abyste předešli konfliktům s jinými bloky, můžete v poli kódu použít proměnnou %selector% spolu s useBlockProps v šabloně vykreslování.

V polích kódu cílí %selector% na konkrétní instanci bloku. V souborech CSS a SCSS cílí %selector% na sdílenou třídu bloku ohraničenou na jeho obsah.

Příklad

Představme si, že chceme v poli kódu cílit na značku h1 z výše uvedeného příkladu.

CSS
%selector% h1 {
  color: red;
}

Nyní Blockstudio provede tři věci:

  • Vytvoří jedinečné ID pro danou instanci bloku
  • Nahradí %selector% tímto jedinečným ID
  • Přidá stejný selektor k prvku označenému pomocí useBlockProps

Výsledný výstup bude vypadat například takto:

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

Automatické vykreslování

Ruční vykreslování tagu style může být pokaždé zdlouhavé. Tento postup si můžete usnadnit použitím atributu asset v poli kódu.

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

Automaticky vytvoří tagy style pro bloky kódu označené jako css a přesune je do hlavičky dokumentu. U polí, jejichž jazyk je označen jako javascript, se místo toho vytvoří tagy script a umístí se na konec těla dokumentu.

V rozšířeních

Při použití polí kódu uvnitř rozšíření není atribut asset potřeba. Blockstudio automaticky vykreslí obsah pole kódu jako prostředek, pokud je jazyk css nebo javascript.

Příklad

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

Není potřeba žádná další konfigurace. Výše uvedené zobrazí v postranním panelu pole kódu pro každý blok core/* a automaticky vykreslí jeho obsah na stránce jako prostředek.

SCSS

Pole kódu podporují kompilaci SCSS. Nastavte jazyk na scss a Blockstudio před vykreslením hodnotu zkompiluje pomocí ScssPhp jako CSS.

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

Funkce SCSS, jako jsou proměnné, vnořování a mixiny, fungují:

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

  h1 {
    color: $primary;
  }

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

V editoru se SCSS kompiluje na straně serveru v reálném čase, takže výsledek vidíte při psaní. Na frontendu ke kompilaci dochází při vykreslování bloku.