Treci la conținut

Resurse pentru câmpul de cod

Pe lângă stilurile și scripturile statice ca fișiere, Blockstudio acceptă și blocuri dinamice de resurse prin câmpul de cod. În funcție de cazul de utilizare, acestea pot fi limitate la bloc.

Utilizare de bază

La nivelul cel mai simplu, puteți reda manual conținutul câmpului de cod în ș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>

Selector limitat la bloc

Pentru a evita conflictele cu alte blocuri, puteți folosi variabila %selector% în interiorul câmpului de cod, împreună cu useBlockProps în șablonul de randare.

În câmpurile de cod, %selector% vizează instanța individuală a blocului. În fișierele CSS și SCSS, %selector% vizează în schimb clasa cu domeniu comun a blocului.

Exemplu

Să presupunem că vrem să vizăm eticheta h1 din exemplul de mai sus în câmpul nostru de cod.

CSS
%selector% h1 {
  color: red;
}

Acum, Blockstudio va face trei lucruri:

  • Creează un ID unic pentru instanța blocului
  • Înlocuiește %selector% cu ID-ul unic
  • Adaugă același selector la elementul marcat cu useBlockProps

Rezultatul final va arăta cam așa:

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

Randare automată

Poate fi anevoios să adăugați manual de fiecare dată eticheta style. Pentru a simplifica procesul, puteți folosi atributul asset în câmpul de cod.

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

Aceasta va crea automat etichete style pentru blocurile de cod marcate cu css și le va muta în head-ul documentului. Pentru câmpurile marcate cu javascript drept limbaj, vor fi create etichete script și plasate la sfârșitul body-ului.

În extensii

La folosirea câmpurilor de cod în cadrul extensiilor, atributul asset nu este necesar. Blockstudio va reda automat conținutul câmpului de cod ca resursă dacă limbajul este css sau javascript.

Exemplu

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

Nu este necesară nicio configurare suplimentară. Cele de mai sus vor afișa un câmp de cod pentru fiecare bloc core/* din bara laterală și vor reda automat conținutul ca resursă în pagină.

SCSS

Câmpurile de cod acceptă compilarea SCSS. Setați limbajul la scss, iar Blockstudio va compila valoarea prin ScssPhp înainte de a o reda ca CSS.

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

Funcționalități SCSS precum variabilele, imbricarea și mixin-urile funcționează:

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

  h1 {
    color: $primary;
  }

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

În editor, SCSS este compilat în timp real pe server, astfel încât vedeți rezultatul pe măsură ce scrieți. În interfața publică, compilarea are loc la redarea blocului.