Resursu apstrāde
Minimizēšana
Blockstudio var automātiski minimizēt visus bloka CSS un JS failus.
Kompilētie faili tiek saglabāti bloka mapē _dist un pievienoti rindai, kad bloks tiek izmantots. Atjauninot avota failu, Blockstudio pārbauda, vai pastāv kompilēts fails ar šo laika zīmogu; ja tāda nav, tas tiek izveidots.
Šim nolūkam tiek izmantota bibliotēka minify.
Minimizēšanu var iespējot, izmantojot iestatījumu assets/minify:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
Ja vēlaties rakstīt stilus valodā SCSS, varat iespējot apstrādi ar SCSS:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
Tas iespējos SCSS apstrādi .css failiem.
Varat arī izmantot paplašinājumu .scss, un stili tiks automātiski apstrādāti pat tad, ja iepriekš minētais iestatījums nav true.
Importēšanas ceļi
Izmantojot SCSS, var importēt citus SCSS failus. Importēšanas ceļi ir relatīvi pret failu, no kura tie tiek importēti.
@import "modules.scss";
Turklāt pielāgotus importēšanas ceļus var definēt, izmantojot filtru blockstudio/assets/process/scss/import_paths, lai failus varētu importēt no citām mapēm, nenorādot mapju struktūru.
Importos var izlaist paplašinājumu .scss un norādīt daļējos failus, piemēram, _tokens.scss, vai mapes _index.scss failu.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
Priekšteksts
Ja vēlaties, lai visos SCSS failos būtu pieejamas koplietojamas Sass funkcijas, mainīgie, miksīni vai utilītas, pirms kompilēšanas varat pievienot globālu priekštekstu.
Tas noder tādiem ietvariem kā Bootstrap, kuros, iespējams, vēlaties izmantot koplietojamus miksīnus, piemēram, pārtraukumpunktus, neatkārtojot importus katra bloka resursu failā.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
Apvienojumā ar blockstudio/assets/process/scss/import_paths tas padara atsauces Sass virsmu pieejamu visiem kompilētajiem failiem.
Bloku resursi tiek kompilēti no jauna, ja mainās atkarības modificēšanas laiks, tostarp failiem, ko importē citi daļējie faili. Blockstudio seko lokālajām @import, @use un @forward atkarībām, tostarp priekšteksta atkarībām un konfigurētajiem importēšanas ceļiem. Koplietojamās atkarības tiek izsekotas vienreiz, un cikli nevar izraisīt bezgalīgu atkārtošanos to atrašanas laikā. Šie faili ir iekļauti arī izpildlaika kešatmiņas uzraudzības sarakstā.
Piemēram, rediģējot mixins/_wysiwyg.scss, tiek atkārtoti kompilēts global-styles.scss, ja tas importē scss/_wysiwyg.scss, kas savukārt importē šo miksīnu. Izmaiņu ieviešanai nav jārediģē sākotnējais fails. Sass iebūvētie moduļi un attālie importi nav iekļauti lokālo atkarību grafikā.
ES moduļi
Visi Blockstudio iekļautie un noklusētie skripti pēc noklusējuma tiek ielādēti, tiem lietojot type="module". Tas nozīmē, ka bloku skriptos var izmantot import sintaksi bez papildu iestatīšanas.
Piezīme
Plašāku informāciju par ES moduļiem skatiet MDN tīmekļa dokumentācijā.
Iedomāsimies šādu kodu script.js iekšpusē:
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")
);
Iepriekš minētais piemērs izveidotu komponentu, izmantojot Preact, importējot visus nepieciešamos komponentus un funkcijas no ESM saderīgas CDN, šajā gadījumā esm.sh. Šai pieejai nav nekādas vainas, taču tās trūkums ir nepieciešamība pieprasīt vajadzīgos resursus no ārējas vietnes, tādējādi riskējot ar bojātiem skriptiem, ja vietne CDN nedarbojas.
Blockstudio piedāvā ērtu veidu, kā lejupielādēt ES moduļus blokā, novēršot vajadzību pēc ārējiem ESM CDN ražošanas vidē.
Iestatīšana
Lai lejupielādētu moduli bloka mapē, izmantojiet prefiksu npm:, kam seko pakotnes nosaukums un versija:
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";
Šī sintakse atbilst Deno specifikāciju norādītāju npm konvencijai.
Piezīme
Mantotais prefikss
blockstudio/(e.g.,blockstudio/preact@10.15.1) joprojām tiek atbalstīts atpakaļsaderības nolūkā, taču jauniem projektiem iesakām izmantot prefiksunpm:. Plašāku informāciju skatiet migrācijas ceļvedī.
Blockstudio automātiski pārbaudīs izmaiņas .js failos, lai atrastu importus, un lejupielādēs tos lokālajā bloka mapē. Lejupielādētie faili tiks ievietoti mapē modules bloka mapē.
Saglabājot skripta failu, tas tiks pārrakstīts, lai izmantotu lokāli mitināto moduli:
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";
Redaktorā priekšskatīšanas laikā un strādājot ar bloku joprojām tiks izmantots CDN URL (Blockstudio izmanto esm.sh).
Ierobežojumi
Versija
Parasti moduļus no CDN var izmantot bez versijas numura. Šādā gadījumā vienmēr tiks izmantota jaunākā versija. Tā kā Blockstudio nesaglabā informāciju datubāzē, moduļu izmantošanai ir nepieciešams versijas numurs.
Vieni un tie paši moduļi
Moduļi ir piesaistīti saviem blokiem. Pat ja vairākos blokos izmantojat vienu un to pašu moduli ar vienādu versijas numuru, Blockstudio tik un tā lejupielādēs pieprasīto moduli blokā. Tas galvenokārt tāpēc, ka blokiem jābūt patstāvīgām vienībām, ko var viegli koplietot citās instalācijās vai vietnēs.
Turklāt viens un tas pats modulis tiks pieprasīts divreiz, ja abi bloki būs lapā. Šo problēmu var atrisināt, izmantojot script-inline.js failu script.js faila vietā. Blockstudio pārrakstīs katru importu, lai tas norādītu uz moduļa pirmās instances atrašanās vietu, ja nosaukums un versijas numurs sakrīt.
CSS ielādētājs
Var importēt arī CSS failus, izmantojot to pašu sintaksi, kas minēta iepriekš.
import "npm:swiper@11.0.0/swiper.min.css";
Fails CSS tiks lejupielādēts mapē modules un automātiski pievienots rindai, kad bloks tiek izmantots. Ja versija ir tā pati, rindai tiks pievienota tikai viena CSS faila versija, pat ja fails ir vairākos blokos.