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
<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>
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.
%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:
<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.
{
"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
{
"$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.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
SCSS-funktioner som variabler, indlejring og mixins fungerer alle:
%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.