Pāriet uz saturu

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:

PHP
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:

PHP
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.

CSS
@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.

PHP
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ā.

PHP
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ē:

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")
);

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:

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";

Šī 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 prefiksu npm:. 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:

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";

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š.

JavaScript
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.