Procesarea resurselor
Minificare
Blockstudio poate minifica automat toate fișierele CSS și JS dintr-un bloc.
Fișierele compilate vor fi salvate în folderul _dist al blocului și adăugate în coadă când este folosit un bloc. Când fișierul sursă este actualizat, Blockstudio verifică dacă există un fișier compilat cu marca temporală respectivă; dacă nu, îl creează.
În acest scop este folosită biblioteca minify.
Minificarea poate fi activată folosind setarea assets/minify:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
Dacă preferați să scrieți stilurile în SCSS, puteți activa procesarea SCSS:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
Aceasta va activa procesarea SCSS pentru fișierele .css.
Alternativ, puteți folosi extensia .scss, iar stilurile vor fi procesate automat chiar și când setarea de mai sus nu este true.
Căi de import
Când folosiți SCSS, puteți importa și alte fișiere SCSS. Importurile sunt relative la fișierul din care sunt importate.
@import "modules.scss";
În plus, puteți defini căi de import personalizate folosind filtrul blockstudio/assets/process/scss/import_paths, astfel încât fișierele să poată fi importate din alte directoare fără a specifica structura folderelor.
Importurile pot omite extensia .scss și pot rezolva parțiale precum _tokens.scss sau fișierul _index.scss al unui director.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
Prelude
Dacă doriți ca funcțiile, variabilele, mixin-urile sau utilitarele Sass partajate să fie disponibile în fiecare fișier SCSS, puteți adăuga un prelude global înainte de compilare.
Acest lucru este util pentru framework-uri precum Bootstrap, când doriți să aveți acces la mixin-uri partajate, cum ar fi punctele de întrerupere, fără a repeta importurile în fiecare resursă de bloc.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
Împreună cu blockstudio/assets/process/scss/import_paths, aceasta face ca suprafața Sass referențiată să fie disponibilă în fiecare fișier compilat.
Resursele blocurilor sunt recompilate când se modifică data ultimei modificări a unei dependențe, inclusiv a fișierelor importate de alte fișiere parțiale. Blockstudio urmărește dependențele locale @import, @use și @forward, inclusiv dependențele prelude și căile de import configurate. Dependențele partajate sunt urmărite o singură dată, iar ciclurile nu pot provoca bucle în timpul detectării. Aceste fișiere sunt incluse și în lista de monitorizare a cache-ului în timpul rulării.
De exemplu, editarea fișierului mixins/_wysiwyg.scss recompilă global-styles.scss când acesta importă scss/_wysiwyg.scss, care la rândul său importă mixin-ul respectiv. Modificările nu necesită atingerea fișierului de intrare. Modulele integrate Sass și importurile la distanță sunt excluse din graficul dependențelor locale.
Module ES
Toate scripturile (inline și implicite) din Blockstudio se încarcă implicit cu type="module" aplicat. Astfel, puteți folosi sintaxa import în scripturile blocurilor, fără configurare suplimentară.
Notă
Pentru o prezentare mai detaliată a modulelor ES, consultați documentația web MDN.
Să ne imaginăm următorul cod într-un script.js:
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")
);
Exemplul de mai sus ar crea o componentă folosind Preact, importând toate componentele și funcțiile necesare dintr-un CDN compatibil cu ESM, în acest caz esm.sh. Abordarea este validă, dar necesită solicitarea resurselor necesare de pe un site extern, ceea ce poate duce la scripturi nefuncționale dacă CDN nu este disponibil.
Blockstudio include o metodă practică de a descărca module ES în bloc, eliminând nevoia de CDN-uri ESM externe în producție.
Configurare
Pentru a descărca un modul în directorul blocului, folosiți prefixul npm: urmat de numele și versiunea pachetului:
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";
Această sintaxă respectă convenția Deno privind npmspecifier.
Notă
Prefixul vechi
blockstudio/(e.g.,blockstudio/preact@10.15.1) este încă acceptat pentru compatibilitate cu versiunile anterioare, dar recomandăm prefixulnpm:pentru proiectele noi. Consultați ghidul de migrare pentru detalii.
Blockstudio va verifica automat fișierele .js modificate pentru importuri și le va descărca în directorul local al blocului. Fișierele descărcate vor fi plasate într-un folder modules din directorul blocului.
La salvare, fișierul script va fi rescris pentru a se adapta modulului găzduit local:
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";
În editor, la previzualizarea și lucrul la bloc, se va folosi în continuare URL-ul CDN (Blockstudio folosește esm.sh).
Aspecte de reținut
Versiune
În mod normal, modulele pot fi folosite din CDN-uri fără numărul versiunii. În acest caz, se va folosi întotdeauna cea mai recentă versiune. Deoarece Blockstudio nu salvează informații în baza de date, este necesar un număr de versiune când folosiți module.
Aceleași module
Modulele sunt izolate în cadrul blocurilor lor. Chiar dacă folosiți același modul cu același număr de versiune în mai multe blocuri, Blockstudio va descărca în continuare modulul solicitat în bloc. Acest lucru se datorează în principal faptului că blocurile ar trebui să fie unități autonome, ușor de partajat cu alte instalări sau site-uri.
În plus, același modul va fi solicitat de două ori dacă ambele blocuri sunt prezente pe pagină. Această problemă poate fi rezolvată folosind script-inline.js în locul fișierului script.js. Blockstudio va rescrie fiecare import pentru a indica locația primei apariții a modulului, dacă numele și numărul versiunii sunt aceleași.
Încărcător CSS
Puteți importa și fișiere CSS folosind aceeași sintaxă ca mai sus.
import "npm:swiper@11.0.0/swiper.min.css";
Fișierul CSS va fi descărcat în folderul modules și adăugat automat în coadă când este folosit blocul. Atât timp cât versiunea este aceeași, va fi adăugată în coadă o singură versiune a fișierului CSS, chiar dacă acesta există în mai multe blocuri.