Kodo laukų ištekliai
Be statinių stilių ir scenarijų failų, Blockstudio taip pat palaiko dinaminius išteklių blokus naudojant kodo lauką. Atsižvelgiant į poreikį, juos galima apriboti konkrečiu bloku.
Pagrindinis naudojimas
Paprasčiausiu atveju kodo lauko turinį šablone galite atvaizduoti rankiniu būdu.
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>
Aprėpties parinkiklis
Kad išvengtumėte konfliktų su kitais blokais, kodo lauke kartu su useBlockProps atvaizdavimo šablone galite naudoti kintamąjį %selector%.
Kodo laukuose %selector% nurodo konkretų bloko egzempliorių. CSS ir SCSS failuose %selector% nurodo bendrą bloko aprėpties klasę.
Pavyzdys
Tarkime, kad kodo lauke norime pasirinkti pirmiau pateiktame pavyzdyje esančią žymą h1.
%selector% h1 {
color: red;
}
Dabar Blockstudio atliks tris veiksmus:
- Sukurs unikalų to bloko egzemplioriaus ID
- Pakeis
%selector%unikaliu ID - Pridės tą patį parinkiklį prie elemento, pažymėto atributu
useBlockProps
Galutinis rezultatas atrodys maždaug taip:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Automatinis atvaizdavimas
Visada rankiniu būdu įterpti stiliaus žymą gali būti nepatogu. Kad tai būtų paprasčiau, kodo lauke galite naudoti atributą asset.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Taip automatiškai sukuriamos žymos style kodo blokams, pažymėtiems kaip css, ir perkeliamos į dokumento antraštę. Laukams, kurių kalba pažymėta kaip javascript, vietoj jų sukuriamos žymos script ir įkeliamos dokumento pabaigoje, prieš uždarant body.
Plėtiniuose
Naudojant kodo laukus plėtiniuose, atributo asset nereikia. Blockstudio automatiškai pateiks kodo lauko turinį kaip išteklių, jei kalba yra css arba javascript.
Pavyzdys
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Papildomos konfigūracijos nereikia. Aukščiau pateikta konfigūracija šoninėje juostoje rodys kodo lauką kiekvienam core/* blokui ir automatiškai pateiks jo turinį puslapyje kaip išteklių.
SCSS
Kodo laukai palaiko SCSS kompiliavimą. Nustatykite kalbą kaip scss, ir Blockstudio prieš pateikdamas reikšmę kaip CSS ją sukompiliuos per ScssPhp.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
Veikia visos SCSS funkcijos, pavyzdžiui, kintamieji, įdėtinės konstrukcijos ir mišiniai:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
Redaktoriuje SCSS kompiliuojamas serveryje realiuoju laiku, todėl rašydami iškart matote rezultatą. Svetainės sąsajoje kompiliuojama atvaizduojant bloką.