Preskoči na vsebino

Sredstva polja kode

Poleg statičnih slogov in skriptov v datotekah Blockstudio podpira tudi dinamične bloke sredstev prek polja kode. Glede na vašo uporabo so lahko omejeni na posamezni blok.

Osnovna uporaba

Na najosnovnejši ravni lahko vsebino polja kode ročno izrišete v predlogi.

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>

Izbirnik z omejenim obsegom

Da se izognete navzkrižjem z drugimi bloki, lahko v polju kode uporabite spremenljivko %selector% skupaj z useBlockProps v predlogi za izris.

V poljih kode %selector% cilja na posamezno instanco bloka. V datotekah CSS in SCSS pa %selector% cilja na skupni razred bloka z omejenim obsegom.

Primer

Predstavljajmo si, da želimo v polju kode ciljati na oznako h1 iz zgornjega primera.

CSS
%selector% h1 {
  color: red;
}

Zdaj bo Blockstudio izvedel tri stvari:

  • Ustvaril bo enolični ID za to instanco bloka
  • Zamenjal bo %selector% z enoličnim ID-jem
  • Isti izbirnik dodal elementu, označenemu z useBlockProps

Končni rezultat bo videti približno takole:

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

Samodejno izrisovanje

Ročno izrisovanje oznake sloga je lahko zamudno. Za lažji postopek lahko v polju kode uporabite atribut asset.

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

To bo samodejno ustvarilo oznake style za bloke kode, označene kot css, in jih premaknilo v glavo dokumenta. Za polja, pri katerih je jezik označen z javascript, bodo namesto tega ustvarjene oznake script in postavljene na konec telesa.

V razširitvah

Pri uporabi kodnih polj znotraj razširitev atribut asset ni potreben. Blockstudio bo vsebino kodnega polja samodejno izrisal kot sredstvo, če je jezik css ali javascript.

Primer

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

Dodatna konfiguracija ni potrebna. Zgornje bo v stranski vrstici prikazalo kodno polje za vsak blok core/* in vsebino samodejno izrisalo kot sredstvo na strani.

SCSS

Kodna polja podpirajo prevajanje SCSS. Jezik nastavite na scss, nato pa bo Blockstudio pred izrisom kot CSS vrednost prevedel prek ScssPhp.

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

Delujejo tudi funkcije SCSS, kot so spremenljivke, gnezdenje in mešalniki:

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

  h1 {
    color: $primary;
  }

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

V urejevalniku se SCSS sproti prevaja na strežniški strani, zato med tipkanjem vidite rezultat. Na vmesniku se prevajanje izvede med izrisovanjem bloka.