Gå til indhold

Kodefeltets assets

Ud over statiske styles og scripts som filer understøtter Blockstudio også dynamiske assetblokke via kodefeltet. Afhængigt af dit brugstilfælde kan de afgrænses til blokken.

Grundlæggende brug

På det mest grundlæggende niveau kan du gengive indholdet af kodefeltet manuelt i din skabelon.

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>

Afgrænset selector

For at undgå konflikter med andre blokke kan du bruge variablen %selector% i kodefeltet sammen med useBlockProps i din gengivelsesskabelon.

I kodefelter retter %selector% sig mod den enkelte blokforekomst. I filerne CSS og SCSS retter %selector% sig i stedet mod blokkens fælles afgrænsede klasse.

Eksempel

Lad os forestille os, at vi vil målrette h1-tagget fra eksemplet ovenfor i vores kodefelt.

CSS
%selector% h1 {
  color: red;
}

Nu gør Blockstudio tre ting:

  • Opretter et unikt id for den blokforekomst
  • Erstatter %selector% med det unikke id
  • Føjer den samme selector til elementet markeret med useBlockProps

Det endelige output ser nogenlunde sådan ud:

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

Automatisk gengivelse

Det kan være besværligt altid at skulle gengive style-tagget manuelt. Du kan gøre processen nemmere ved at bruge attributten asset i kodefeltet.

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

Dette opretter automatisk style-tags for kodeblokke markeret som css og flytter dem til dokumentets head. For felter, hvor javascript er angivet som sproget, oprettes i stedet script-tags, som placeres nederst i body.

I udvidelser

Når du bruger kodefelter i udvidelser, er attributten asset ikke nødvendig. Blockstudio gengiver automatisk indholdet af kodefeltet som et aktiv, hvis sproget er css eller javascript.

Eksempel

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

Der kræves ingen yderligere konfiguration. Koden ovenfor viser et kodefelt for hver core/*-blok i sidepanelet og gengiver automatisk indholdet som et aktiv på siden.

SCSS

Kodefelter understøtter kompilering af SCSS. Angiv sproget som scss, så kompilerer Blockstudio værdien via ScssPhp, før den gengives som CSS.

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

SCSS-funktioner som variabler, indlejring og mixins fungerer alle:

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

  h1 {
    color: $primary;
  }

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

I editoren kompileres SCSS på serversiden i realtid, så du kan se resultatet, mens du skriver. På frontend sker kompileringen, når blokken gengives.