Resurse pentru câmpul de cod
Pe lângă stilurile și scripturile statice ca fișiere, Blockstudio acceptă și blocuri dinamice de resurse prin câmpul de cod. În funcție de cazul de utilizare, acestea pot fi limitate la bloc.
Utilizare de bază
La nivelul cel mai simplu, puteți reda manual conținutul câmpului de cod în șablon.
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>
Selector limitat la bloc
Pentru a evita conflictele cu alte blocuri, puteți folosi variabila %selector% în interiorul câmpului de cod, împreună cu useBlockProps în șablonul de randare.
În câmpurile de cod, %selector% vizează instanța individuală a blocului. În fișierele CSS și SCSS, %selector% vizează în schimb clasa cu domeniu comun a blocului.
Exemplu
Să presupunem că vrem să vizăm eticheta h1 din exemplul de mai sus în câmpul nostru de cod.
%selector% h1 {
color: red;
}
Acum, Blockstudio va face trei lucruri:
- Creează un ID unic pentru instanța blocului
- Înlocuiește
%selector%cu ID-ul unic - Adaugă același selector la elementul marcat cu
useBlockProps
Rezultatul final va arăta cam așa:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Randare automată
Poate fi anevoios să adăugați manual de fiecare dată eticheta style. Pentru a simplifica procesul, puteți folosi atributul asset în câmpul de cod.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Aceasta va crea automat etichete style pentru blocurile de cod marcate cu css și le va muta în head-ul documentului. Pentru câmpurile marcate cu javascript drept limbaj, vor fi create etichete script și plasate la sfârșitul body-ului.
În extensii
La folosirea câmpurilor de cod în cadrul extensiilor, atributul asset nu este necesar. Blockstudio va reda automat conținutul câmpului de cod ca resursă dacă limbajul este css sau javascript.
Exemplu
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Nu este necesară nicio configurare suplimentară. Cele de mai sus vor afișa un câmp de cod pentru fiecare bloc core/* din bara laterală și vor reda automat conținutul ca resursă în pagină.
SCSS
Câmpurile de cod acceptă compilarea SCSS. Setați limbajul la scss, iar Blockstudio va compila valoarea prin ScssPhp înainte de a o reda ca CSS.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
Funcționalități SCSS precum variabilele, imbricarea și mixin-urile funcționează:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
În editor, SCSS este compilat în timp real pe server, astfel încât vedeți rezultatul pe măsură ce scrieți. În interfața publică, compilarea are loc la redarea blocului.