Ga naar de inhoud

Codeveldassets

Naast statische styles en scripts als bestanden ondersteunt Blockstudio ook dynamische assetblokken via het codeveld. Afhankelijk van je gebruikssituatie kunnen deze aan het blok worden gekoppeld.

Basisgebruik

Op het meest basale niveau kun je de inhoud van het codeveld handmatig in je sjabloon weergeven.

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>

Afgebakende selector

Om conflicten met andere blokken te voorkomen, kun je de variabele %selector% in het codeveld gebruiken, samen met useBlockProps in je weergavesjabloon.

In codevelden richt %selector% zich op de afzonderlijke blokinstantie. In bestanden CSS en SCSS richt %selector% zich in plaats daarvan op de gedeelde, afgebakende klasse van het blok.

Voorbeeld

Stel dat we in ons codeveld de h1-tag uit het bovenstaande voorbeeld willen targeten.

CSS
%selector% h1 {
  color: red;
}

Blockstudio doet nu drie dingen:

  • Maakt een unieke ID aan voor die blokinstantie
  • Vervangt %selector% door de unieke ID
  • Voegt dezelfde selector toe aan het element met markering useBlockProps

De uiteindelijke uitvoer ziet er ongeveer zo uit:

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

Automatisch renderen

Het style-tag steeds handmatig moeten renderen kan omslachtig zijn. Om dit proces eenvoudiger te maken, kun je het attribuut asset in het codeveld gebruiken.

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

Hierdoor worden automatisch style-tags gemaakt voor codeblokken die zijn gemarkeerd als css en worden ze naar de head van het document verplaatst. Voor velden waarbij javascript als taal is ingesteld, worden in plaats daarvan script-tags gemaakt en onderaan de body geplaatst.

In extensies

Bij het gebruik van codevelden in extensies is het attribuut asset niet nodig. Blockstudio rendert de inhoud van het codeveld automatisch als asset wanneer de taal is ingesteld op css of javascript.

Voorbeeld

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

Er is geen extra configuratie nodig. Met het bovenstaande wordt voor elk core/*-blok een codeveld in de zijbalk weergegeven en wordt de inhoud automatisch als asset aan de pagina toegevoegd.

SCSS

Codevelden ondersteunen compilatie van SCSS. Stel de taal in op scss; Blockstudio compileert de waarde dan via ScssPhp voordat deze als CSS wordt gerenderd.

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

SCSS-functies zoals variabelen, nesting en mixins werken allemaal:

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

  h1 {
    color: $primary;
  }

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

In de editor wordt SCSS in realtime aan de serverzijde gecompileerd, zodat je het resultaat ziet terwijl je typt. Aan de voorkant vindt de compilatie plaats tijdens het renderen van het blok.