Asset dei campi di codice
Oltre agli stili e agli script statici in file, Blockstudio supporta anche blocchi di asset dinamici tramite il campo di codice. A seconda del caso d’uso, possono essere circoscritti al blocco.
Utilizzo di base
Al livello più semplice, potete visualizzare manualmente il contenuto del campo di codice nel vostro template.
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>
Selettore circoscritto
Per evitare conflitti con altri blocchi, potete usare la variabile %selector% nel campo di codice insieme a useBlockProps nel template di rendering.
Nei campi di codice, %selector% seleziona la singola istanza del blocco. Nei file CSS e SCSS, invece, %selector% seleziona la classe circoscritta condivisa del blocco.
Esempio
Immaginiamo di voler selezionare il tag h1 dell’esempio qui sopra nel nostro campo di codice.
%selector% h1 {
color: red;
}
A questo punto, Blockstudio farà tre cose:
- Creare un ID univoco per quell’istanza del blocco
- Sostituire
%selector%con l’ID univoco - Aggiungere lo stesso selettore all’elemento contrassegnato con
useBlockProps
Il risultato finale sarà simile a questo:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Rendering automatico
Dover renderizzare manualmente il tag style ogni volta può essere scomodo. Per semplificare questo processo, potete usare l’attributo asset all’interno del campo di codice.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
In questo modo verranno creati automaticamente tag style per i blocchi di codice contrassegnati come css e spostati nell’head del documento. Per i campi contrassegnati con javascript come lingua, verranno creati tag script, posizionati in fondo al body.
Nelle estensioni
Quando usate campi di codice all’interno delle estensioni, l’attributo asset non è necessario. Blockstudio renderà automaticamente il contenuto del campo di codice come risorsa se la lingua è css o javascript.
Esempio
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Non è necessaria alcuna configurazione aggiuntiva. Quanto sopra mostrerà un campo di codice per ogni blocco core/* nella barra laterale e renderà automaticamente il contenuto come risorsa nella pagina.
SCSS
I campi di codice supportano la compilazione di SCSS. Impostate la lingua su scss e Blockstudio compilerà il valore tramite ScssPhp prima di renderizzarlo come CSS.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
Funzionalità di SCSS come variabili, annidamento e mixin funzionano tutte:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
Nell’editor, SCSS viene compilato lato server in tempo reale, così potete vedere il risultato mentre scrivete. Nel frontend, la compilazione avviene durante il rendering del blocco.