Vai al contenuto

Asset dei campi di codice

Oltre agli stili e agli script statici in file, Blockstudio supporta anche blocchi di asset dinamici tramite il campo di codice. A seconda del caso d’uso, possono essere circoscritti al blocco.

Utilizzo di base

Al livello più semplice, potete visualizzare manualmente il contenuto del campo di codice nel vostro template.

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>

Selettore circoscritto

Per evitare conflitti con altri blocchi, potete usare la variabile %selector% nel campo di codice insieme a useBlockProps nel template di rendering.

Nei campi di codice, %selector% seleziona la singola istanza del blocco. Nei file CSS e SCSS, invece, %selector% seleziona la classe circoscritta condivisa del blocco.

Esempio

Immaginiamo di voler selezionare il tag h1 dell’esempio qui sopra nel nostro campo di codice.

CSS
%selector% h1 {
  color: red;
}

A questo punto, Blockstudio farà tre cose:

  • Creare un ID univoco per quell’istanza del blocco
  • Sostituire %selector% con l’ID univoco
  • Aggiungere lo stesso selettore all’elemento contrassegnato con useBlockProps

Il risultato finale sarà simile a questo:

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

Rendering automatico

Dover renderizzare manualmente il tag style ogni volta può essere scomodo. Per semplificare questo processo, potete usare l’attributo asset all’interno del campo di codice.

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

In questo modo verranno creati automaticamente tag style per i blocchi di codice contrassegnati come css e spostati nell’head del documento. Per i campi contrassegnati con javascript come lingua, verranno creati tag script, posizionati in fondo al body.

Nelle estensioni

Quando usate campi di codice all’interno delle estensioni, l’attributo asset non è necessario. Blockstudio renderà automaticamente il contenuto del campo di codice come risorsa se la lingua è css o javascript.

Esempio

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

Non è necessaria alcuna configurazione aggiuntiva. Quanto sopra mostrerà un campo di codice per ogni blocco core/* nella barra laterale e renderà automaticamente il contenuto come risorsa nella pagina.

SCSS

I campi di codice supportano la compilazione di SCSS. Impostate la lingua su scss e Blockstudio compilerà il valore tramite ScssPhp prima di renderizzarlo come CSS.

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

Funzionalità di SCSS come variabili, annidamento e mixin funzionano tutte:

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

  h1 {
    color: $primary;
  }

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

Nell’editor, SCSS viene compilato lato server in tempo reale, così potete vedere il risultato mentre scrivete. Nel frontend, la compilazione avviene durante il rendering del blocco.