Zum Inhalt springen

Codefeld-Assets

Neben statischen Stylesheets und Skripten als Dateien unterstützt Blockstudio auch dynamische Asset-Blöcke über das Codefeld. Je nach Anwendungsfall lassen sich diese auf den Block beschränken.

Grundlegende Verwendung

Ganz einfach kannst du den Inhalt des Codefelds manuell in deiner Vorlage ausgeben.

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>

Bereichsbezogener Selektor

Um Konflikte mit anderen Blöcken zu vermeiden, kannst du die Variable %selector% im Codefeld zusammen mit useBlockProps in deiner Darstellungsvorlage verwenden.

In Codefeldern zielt %selector% auf die einzelne Blockinstanz. In den Dateien CSS und SCSS zielt %selector% dagegen auf die gemeinsame, bereichsbezogene Klasse des Blocks.

Beispiel

Nehmen wir an, wir möchten in unserem Codefeld das Tag h1 aus dem obigen Beispiel ansprechen.

CSS
%selector% h1 {
  color: red;
}

Jetzt erledigt Blockstudio drei Dinge:

  • Erstellt eine eindeutige ID für diese Blockinstanz
  • Ersetzt %selector% durch die eindeutige ID
  • Fügt denselben Selektor zum Element mit der Markierung useBlockProps hinzu

Die endgültige Ausgabe sieht etwa so aus:

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

Automatische Ausgabe

Es kann umständlich sein, das Style-Tag jedes Mal manuell rendern zu müssen. Um den Vorgang zu vereinfachen, kannst du das Attribut asset im Codefeld verwenden.

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

Dadurch werden automatisch style-Tags für Codeblöcke mit der Kennzeichnung css erstellt und in den Head des Dokuments verschoben. Für Felder, deren Sprache mit javascript gekennzeichnet ist, werden stattdessen script-Tags erstellt und am Ende des Bodys eingefügt.

In Erweiterungen

Wenn du Codefelder innerhalb von Erweiterungen verwendest, ist das Attribut asset nicht erforderlich. Blockstudio rendert den Inhalt des Codefelds automatisch als Asset, wenn die Sprache css oder javascript ist.

Beispiel

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

Es ist keine zusätzliche Konfiguration erforderlich. Damit wird für jeden core/*-Block eine Codefeldleiste in der Seitenleiste angezeigt und der Inhalt automatisch als Asset auf der Seite gerendert.

SCSS

Codefelder unterstützen die Kompilierung von SCSS. Setze die Sprache auf scss, und Blockstudio kompiliert den Wert mit ScssPhp, bevor er als CSS gerendert wird.

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

SCSS-Funktionen wie Variablen, Verschachtelungen und Mixins funktionieren alle:

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

  h1 {
    color: $primary;
  }

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

Im Editor wird SCSS serverseitig in Echtzeit kompiliert, sodass du das Ergebnis während der Eingabe siehst. Im Frontend erfolgt die Kompilierung beim Rendern des Blocks.