Koda lauka aktīvi
Līdztekus statiskiem stiliem un skriptiem, kas glabājas failos, Blockstudio atbalsta arī dinamiskus aktīvu blokus, izmantojot koda lauku. Atkarībā no lietojuma tos var ierobežot līdz konkrētam blokam.
Pamata lietojums
Vienkāršākajā gadījumā veidnē varat manuāli renderēt koda lauka saturu.
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>
Ierobežots selektors
Lai izvairītos no konfliktiem ar citiem blokiem, veidnes renderēšanai kopā ar useBlockProps koda laukā varat izmantot mainīgo %selector%.
Koda laukos %selector% atlasa atsevišķu bloka instanci. Failos CSS un SCSS %selector% tā vietā atlasa bloka koplietojamo ierobežotās darbības klasi.
Piemērs
Pieņemsim, ka koda laukā vēlamies atlasīt iepriekšējā piemērā norādīto tagu h1.
%selector% h1 {
color: red;
}
Tagad Blockstudio veiks trīs darbības:
- Izveidos unikālu ID šai bloka instancei
- Aizstās
%selector%ar unikālo ID - Pievienos to pašu selektoru elementam, kas apzīmēts ar
useBlockProps
Gala rezultāts būs aptuveni šāds:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Automātiska renderēšana
Stila tagu manuāla renderēšana ikreiz var būt apgrūtinoša. Lai šo procesu atvieglotu, koda laukā varat izmantot atribūtu asset.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Tas automātiski izveidos style tagus koda blokiem, kas atzīmēti ar css, un pārvietos tos uz dokumenta head sadaļu. Laukiem, kuros valoda atzīmēta ar javascript, tiks izveidoti script tagi un ievietoti body sadaļas apakšā.
Paplašinājumos
Izmantojot koda laukus paplašinājumos, atribūts asset nav nepieciešams. Blockstudio automātiski renderēs koda lauka saturu kā resursu, ja valoda ir css vai javascript.
Piemērs
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Papildu konfigurācija nav nepieciešama. Iepriekš minētais sānjoslā parādīs koda lauku katram core/* blokam un automātiski renderēs saturu kā lapas resursu.
SCSS
Koda lauki atbalsta SCSS kompilēšanu. Iestatiet valodu uz scss, un Blockstudio pirms renderēšanas kā CSS kompilēs vērtību, izmantojot ScssPhp.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
Darbojas visas SCSS iespējas, piemēram, mainīgie, ligzdošana un miksīni:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
Redaktorā SCSS tiek kompilēts servera pusē reāllaikā, tāpēc rezultātu redzat rakstīšanas laikā. Priekšpusē kompilēšana notiek bloka renderēšanas laikā.