Sredstva polja kode
Poleg statičnih slogov in skriptov v datotekah Blockstudio podpira tudi dinamične bloke sredstev prek polja kode. Glede na vašo uporabo so lahko omejeni na posamezni blok.
Osnovna uporaba
Na najosnovnejši ravni lahko vsebino polja kode ročno izrišete v predlogi.
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>
Izbirnik z omejenim obsegom
Da se izognete navzkrižjem z drugimi bloki, lahko v polju kode uporabite spremenljivko %selector% skupaj z useBlockProps v predlogi za izris.
V poljih kode %selector% cilja na posamezno instanco bloka. V datotekah CSS in SCSS pa %selector% cilja na skupni razred bloka z omejenim obsegom.
Primer
Predstavljajmo si, da želimo v polju kode ciljati na oznako h1 iz zgornjega primera.
%selector% h1 {
color: red;
}
Zdaj bo Blockstudio izvedel tri stvari:
- Ustvaril bo enolični ID za to instanco bloka
- Zamenjal bo
%selector%z enoličnim ID-jem - Isti izbirnik dodal elementu, označenemu z
useBlockProps
Končni rezultat bo videti približno takole:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Samodejno izrisovanje
Ročno izrisovanje oznake sloga je lahko zamudno. Za lažji postopek lahko v polju kode uporabite atribut asset.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
To bo samodejno ustvarilo oznake style za bloke kode, označene kot css, in jih premaknilo v glavo dokumenta. Za polja, pri katerih je jezik označen z javascript, bodo namesto tega ustvarjene oznake script in postavljene na konec telesa.
V razširitvah
Pri uporabi kodnih polj znotraj razširitev atribut asset ni potreben. Blockstudio bo vsebino kodnega polja samodejno izrisal kot sredstvo, če je jezik css ali javascript.
Primer
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Dodatna konfiguracija ni potrebna. Zgornje bo v stranski vrstici prikazalo kodno polje za vsak blok core/* in vsebino samodejno izrisalo kot sredstvo na strani.
SCSS
Kodna polja podpirajo prevajanje SCSS. Jezik nastavite na scss, nato pa bo Blockstudio pred izrisom kot CSS vrednost prevedel prek ScssPhp.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
Delujejo tudi funkcije SCSS, kot so spremenljivke, gnezdenje in mešalniki:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
V urejevalniku se SCSS sproti prevaja na strežniški strani, zato med tipkanjem vidite rezultat. Na vmesniku se prevajanje izvede med izrisovanjem bloka.