Koodivälja varad
Lisaks failidena määratletud staatilistele stiilidele ja skriptidele toetab Blockstudio ka dünaamilisi varaplokke koodivälja kaudu. Olenevalt kasutusjuhtumist saab need piirata konkreetse plokiga.
Põhikasutus
Kõige lihtsamal juhul saate koodivälja sisu oma mallis käsitsi renderdada.
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>
Piiratud ulatusega valija
Teiste plokkidega konfliktide vältimiseks saate kasutada koodivälja sees muutujat %selector% ning renderdusmallis useBlockProps funktsiooni.
Koodiväljadel viitab %selector% konkreetsele ploki eksemplarile. Failides CSS ja SCSS viitab %selector% hoopis ploki ühisele piiratud ulatusega klassile.
Näide
Oletame, et soovime koodiväljas sihtida ülaltoodud näite silti h1.
%selector% h1 {
color: red;
}
Nüüd teeb Blockstudio kolm asja:
- Loob sellele ploki eksemplarile kordumatu ID
- Asendab
%selector%kordumatu ID-ga - Lisab sama valija elemendile, millel on märge
useBlockProps
Lõpptulemus on umbes selline:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Automaatne renderdamine
Stiilisildi käsitsi lisamine iga kord võib olla tülikas. Selle lihtsustamiseks saate kasutada koodiväljal atribuuti asset.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
See loob automaatselt koodiplokkidele, mis on märgitud kui css, sildid style ja paigutab need dokumendi päisesse. Keelena javascript-ga märgitud väljade puhul luuakse selle asemel sildid script ja paigutatakse need body-osa lõppu.
Laiendustes
Kui kasutate koodivälju laiendustes, pole atribuut asset vajalik. Blockstudio renderdab koodivälja sisu automaatselt varana, kui keel on css või javascript.
Näide
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Lisaseadistusi pole vaja. Eelnev kuvab külgribal iga core/* ploki jaoks koodivälja ja renderdab selle sisu automaatselt lehe varana.
SCSS
Koodiväljad toetavad SCSS kompileerimist. Määrake keeleks scss ning Blockstudio kompileerib väärtuse enne selle CSS-na renderdamist läbi ScssPhp.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
SCSS funktsioonid, näiteks muutujad, pesastamine ja miksinid, töötavad kõik:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
Redaktoris kompileeritakse SCSS reaalajas serveris, nii et näete tulemust kirjutamise ajal. Veebilehel toimub kompileerimine ploki renderdamisel.