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
<div useBlockProps>
<h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>
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.
%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
useBlockPropshinzu
Die endgültige Ausgabe sieht etwa so aus:
<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.
{
"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
{
"$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.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
SCSS-Funktionen wie Variablen, Verschachtelungen und Mixins funktionieren alle:
%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.