Hoppa till innehåll

Tillgångar för kodfält

Utöver statiska formatmallar och skript som filer stöder Blockstudio även dynamiska tillgångsblock via kodfältet. Beroende på användningsfallet kan dessa begränsas till blocket.

Grundläggande användning

På enklaste nivå kan du återge kodfältets innehåll manuellt i mallen.

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>

Begränsad väljare

För att undvika konflikter med andra block kan du använda variabeln %selector% i kodfältet tillsammans med useBlockProps i renderingsmallen.

I kodfält riktar %selector% in sig på den enskilda blockinstansen. I filerna CSS och SCSS riktar %selector% i stället in sig på blockets gemensamma begränsade klass.

Exempel

Låt oss säga att vi vill rikta in oss på taggen h1 från exemplet ovan i kodfältet.

CSS
%selector% h1 {
  color: red;
}

Nu gör Blockstudio tre saker:

  • Skapar ett unikt ID för blockinstansen
  • Ersätter %selector% med det unika ID:t
  • Lägger till samma väljare på elementet som markerats med useBlockProps

Slutresultatet ser ut ungefär så här:

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

Automatisk återgivning

Det kan vara omständligt att alltid behöva lägga till style-taggen manuellt. Du kan förenkla processen genom att använda attributet asset i kodfältet.

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

Då skapas automatiskt style-taggar för kodblock markerade som css, och de flyttas till dokumentets head. För fält där språket markeras med javascript skapas i stället script-taggar, som placeras längst ned i body.

I tillägg

När du använder kodfält i tillägg behövs inte attributet asset. Blockstudio renderar automatiskt kodfältets innehåll som en tillgång om språket är css eller javascript.

Exempel

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

Ingen ytterligare konfiguration behövs. Då visas ett kodfält för varje core/*-block i sidofältet, och innehållet renderas automatiskt som en tillgång på sidan.

SCSS

Kodfält stöder kompilering av SCSS. Ange språket som scss så kompilerar Blockstudio värdet med ScssPhp innan det renderas som CSS.

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

Funktioner i SCSS som variabler, nästling och mixins fungerar som de ska:

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

  h1 {
    color: $primary;
  }

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

I redigeraren kompileras SCSS på serversidan i realtid, så att du ser resultatet medan du skriver. På webbplatsens framsida sker kompileringen när blocket renderas.