Prostriedky poľa kódu
Okrem statických štýlov a skriptov uložených v súboroch podporuje Blockstudio aj dynamické bloky prostriedkov prostredníctvom poľa kódu. Podľa konkrétneho prípadu použitia ich možno obmedziť na daný blok.
Základné použitie
V najjednoduchšom prípade môžete obsah poľa kódu vykresliť ručne vo svojej šablóne.
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>
Selektor obmedzený na blok
Ak sa chcete vyhnúť konfliktom s ostatnými blokmi, v poli kódu môžete použiť premennú %selector% spolu s useBlockProps vo vykresľovacej šablóne.
V poliach kódu selektor %selector% zacieľuje konkrétnu inštanciu bloku. V súboroch CSS a SCSS zacieľuje %selector% zdieľanú triedu bloku obmedzenú na daný blok.
Príklad
Predstavme si, že v poli kódu chceme zacieliť na značku h1 z príkladu vyššie.
%selector% h1 {
color: red;
}
Teraz Blockstudio vykoná tri úlohy:
- Vytvorí jedinečné ID pre danú inštanciu bloku
- Nahradí
%selector%týmto jedinečným ID - Pridá rovnaký selektor k prvku označenému pomocou
useBlockProps
Výsledok bude vyzerať približne takto:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Automatické vykresľovanie
Ručné vykresľovanie značky štýlu môže byť zdĺhavé. Tento proces si môžete zjednodušiť použitím atribútu asset v poli kódu.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Automaticky sa vytvoria značky style pre bloky kódu označené ako css a presunú sa do hlavičky dokumentu. Pre polia, v ktorých je ako jazyk označené javascript, sa namiesto toho vytvoria značky script a umiestnia sa na koniec tela dokumentu.
V rozšíreniach
Pri používaní polí kódu v rámci rozšírení nie je atribút asset potrebný. Blockstudio automaticky vykreslí obsah poľa kódu ako zdrojový súbor, ak je jazykom css alebo javascript.
Príklad
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Nie je potrebná žiadna ďalšia konfigurácia. Uvedené nastavenie zobrazí pole kódu pre každý blok core/* na bočnom paneli a automaticky vykreslí jeho obsah na stránke ako zdrojový súbor.
SCSS
Polia kódu podporujú kompiláciu SCSS. Nastavte jazyk na scss a Blockstudio pred vykreslením hodnotu skompiluje cez ScssPhp ako CSS.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
Funkcie SCSS, ako sú premenné, vnáranie a mixiny, fungujú:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
V editore sa SCSS kompiluje v reálnom čase na serveri, takže výsledok vidíte počas písania. Na frontende prebieha kompilácia pri vykresľovaní bloku.