Vai al contenuto

Elaborazione delle risorse

Minimizzazione

Blockstudio può minimizzare automaticamente tutti i file CSS e JS di un blocco.

I file compilati vengono salvati nella cartella _dist del blocco e accodati quando il blocco viene utilizzato. Quando il file sorgente viene aggiornato, Blockstudio verifica se esiste un file compilato con quel timestamp; in caso contrario, lo crea.

A questo scopo viene usata la libreria minify.

La minimizzazione può essere abilitata con l’impostazione assets/minify:

PHP
add_filter('blockstudio/settings/assets/minify/css', function() {
  return true;
});

add_filter('blockstudio/settings/assets/minify/js', function() {
  return true;
});

SCSS

Se preferite scrivere i vostri stili in SCSS, potete abilitare l’elaborazione di SCSS:

PHP
add_filter('blockstudio/settings/assets/process/scss', function() {
  return true;
});

In questo modo verrà abilitata l’elaborazione di SCSS per i file .css.

In alternativa, potete usare l’estensione .scss e gli stili verranno elaborati automaticamente anche quando l’impostazione precedente non è true.

Percorsi di importazione

Quando usate SCSS, potete importare altri file SCSS. I percorsi di importazione sono relativi al file da cui vengono importati.

CSS
@import "modules.scss";

Inoltre, potete definire percorsi di importazione personalizzati usando il filtro blockstudio/assets/process/scss/import_paths, così da importare file da altre directory senza specificare la struttura delle cartelle.

Nelle importazioni potete omettere l’estensione .scss e risolvere parziali come _tokens.scss o il file _index.scss di una directory.

PHP
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
  $paths[] = get_template_directory() . '/scss';
  return $paths;
});

Prefisso

Se volete avere funzioni, variabili, mixin o utilità Sass condivise in ogni file SCSS, potete aggiungere un prefisso globale prima della compilazione.

È utile per framework come Bootstrap, per esempio se volete accedere a mixin condivisi come i breakpoint senza ripetere le importazioni in ogni risorsa del blocco.

PHP
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
  return '@import "functions";' . "\n"
    . '@import "variables";' . "\n"
    . '@import "mixins";';
}, 10, 3);

Insieme a blockstudio/assets/process/scss/import_paths, rende disponibili a ogni file compilato le superfici Sass a cui si fa riferimento.

Le risorse dei blocchi vengono ricompilate quando cambia l’ora di modifica di una dipendenza, compresi i file importati da altri parziali. Blockstudio segue le dipendenze locali di @import, @use e @forward, incluse quelle del prefisso e i percorsi di importazione configurati. Le dipendenze condivise vengono tracciate una sola volta e i cicli non possono causare loop durante l’individuazione. Questi file vengono inclusi anche nell’elenco di controllo della cache di runtime.

Per esempio, modificando mixins/_wysiwyg.scss viene ricompilato global-styles.scss se importa scss/_wysiwyg.scss, che a sua volta importa quel mixin. Per applicare le modifiche non è necessario intervenire sul file di ingresso. I moduli integrati di Sass e le importazioni remote sono esclusi dal grafo delle dipendenze locali.

Moduli ES

Per impostazione predefinita, tutti gli script (in linea e predefiniti) in Blockstudio vengono caricati con type="module" applicato. Questo consente di usare la sintassi import per gli script dei vostri blocchi senza alcuna configurazione aggiuntiva.

Nota

Per un approfondimento sui moduli ES, consultate la documentazione web di MDN.

Immaginiamo il seguente codice all’interno di un script.js:

JavaScript
import { h, render } from "https://esm.sh/preact@10.15.1";
import htm from "https://esm.sh/htm@3.1.1";
import confetti from "https://esm.sh/canvas-confetti@1.6.0";

const html = htm.bind(h);

function App(props) {
  confetti();
  return html`<h1>Hello ${props.name}!</h1>`;
}

render(
  html`<${App} name="Hello from Preact!" />`,
  document.querySelector("#element")
);

L’esempio sopra creerebbe un componente usando Preact, importando tutti i componenti e le funzioni necessari da un CDN compatibile con ESM, in questo caso esm.sh. Questo approccio non presenta problemi, ma richiede di caricare le risorse necessarie da un sito esterno, con il rischio che gli script smettano di funzionare se CDN non è raggiungibile.

Blockstudio include un modo pratico per scaricare moduli ES nel blocco, eliminando la necessità di CDN ESM esterni in produzione.

Configurazione

Per scaricare un modulo nella directory del blocco, usate il prefisso npm: seguito dal nome e dalla versione del pacchetto:

JavaScript
import { h, render } from "npm:preact@10.15.1";
import htm from "npm:htm@3.1.1";
import confetti from "npm:canvas-confetti@1.6.0";

Questa sintassi segue la convenzione degli identificatori Denonpm.

Nota

Il prefisso legacy blockstudio/ (e.g., blockstudio/preact@10.15.1) è ancora supportato per garantire la retrocompatibilità, ma per i nuovi progetti consigliamo di usare il prefisso npm:. Consultate la guida alla migrazione per maggiori dettagli.

Blockstudio controllerà automaticamente i file .js modificati per individuare le importazioni e scaricarli nella directory locale del blocco. I file scaricati verranno inseriti in una cartella modules nella directory del blocco.

Al salvataggio, il file di script verrà riscritto per adattarlo al modulo ospitato localmente:

JavaScript
import { h, render } from "./modules/preact/10.15.1.js";
import htm from "./modules/htm/10.15.1.js";
import confetti from "./modules/canvas-confetti/1.6.0.js";

Nell’editor verrà comunque usato l’URL CDN (Blockstudio usa esm.sh) durante l’anteprima e la modifica del blocco.

Avvertenze

Versione

Di norma, è possibile usare i moduli dalle CDN senza specificare il numero di versione. In questo caso viene sempre usata la versione più recente. Poiché Blockstudio non salva informazioni nel database, quando si usano moduli è necessario specificare un numero di versione.

Moduli uguali

I moduli sono associati ai singoli blocchi. Anche se usate lo stesso modulo con la stessa versione in più blocchi, Blockstudio scaricherà comunque il modulo richiesto nel blocco. Questo perché i blocchi dovrebbero essere unità autonome, facili da condividere con altre installazioni o siti.

Inoltre, lo stesso modulo verrà richiesto due volte se entrambi i blocchi sono presenti in una pagina. Potete risolvere il problema usando script-inline.js al posto del file script.js. Blockstudio riscriverà ciascuna importazione indirizzandola alla posizione della prima occorrenza del modulo, se il nome e il numero di versione corrispondono.

Loader di CSS

È possibile importare anche file CSS usando la stessa sintassi descritta sopra.

JavaScript
import "npm:swiper@11.0.0/swiper.min.css";

Il file CSS verrà scaricato nella cartella modules e accodato automaticamente quando il blocco viene utilizzato. Se la versione è la stessa, verrà accodata una sola versione del file CSS, anche se è presente in più blocchi.