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
<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>
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.
%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:
<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.
{
"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
{
"$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.
{
"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:
%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.