Codeveldassets
Naast statische styles en scripts als bestanden ondersteunt Blockstudio ook dynamische assetblokken via het codeveld. Afhankelijk van je gebruikssituatie kunnen deze aan het blok worden gekoppeld.
Basisgebruik
Op het meest basale niveau kun je de inhoud van het codeveld handmatig in je sjabloon weergeven.
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>
Afgebakende selector
Om conflicten met andere blokken te voorkomen, kun je de variabele %selector% in het codeveld gebruiken, samen met useBlockProps in je weergavesjabloon.
In codevelden richt %selector% zich op de afzonderlijke blokinstantie. In bestanden CSS en SCSS richt %selector% zich in plaats daarvan op de gedeelde, afgebakende klasse van het blok.
Voorbeeld
Stel dat we in ons codeveld de h1-tag uit het bovenstaande voorbeeld willen targeten.
%selector% h1 {
color: red;
}
Blockstudio doet nu drie dingen:
- Maakt een unieke ID aan voor die blokinstantie
- Vervangt
%selector%door de unieke ID - Voegt dezelfde selector toe aan het element met markering
useBlockProps
De uiteindelijke uitvoer ziet er ongeveer zo uit:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Automatisch renderen
Het style-tag steeds handmatig moeten renderen kan omslachtig zijn. Om dit proces eenvoudiger te maken, kun je het attribuut asset in het codeveld gebruiken.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Hierdoor worden automatisch style-tags gemaakt voor codeblokken die zijn gemarkeerd als css en worden ze naar de head van het document verplaatst. Voor velden waarbij javascript als taal is ingesteld, worden in plaats daarvan script-tags gemaakt en onderaan de body geplaatst.
In extensies
Bij het gebruik van codevelden in extensies is het attribuut asset niet nodig. Blockstudio rendert de inhoud van het codeveld automatisch als asset wanneer de taal is ingesteld op css of javascript.
Voorbeeld
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Er is geen extra configuratie nodig. Met het bovenstaande wordt voor elk core/*-blok een codeveld in de zijbalk weergegeven en wordt de inhoud automatisch als asset aan de pagina toegevoegd.
SCSS
Codevelden ondersteunen compilatie van SCSS. Stel de taal in op scss; Blockstudio compileert de waarde dan via ScssPhp voordat deze als CSS wordt gerenderd.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
SCSS-functies zoals variabelen, nesting en mixins werken allemaal:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
In de editor wordt SCSS in realtime aan de serverzijde gecompileerd, zodat je het resultaat ziet terwijl je typt. Aan de voorkant vindt de compilatie plaats tijdens het renderen van het blok.