Obdelava sredstev
Pomanjševanje
Blockstudio lahko samodejno pomanjša vse datoteke CSS in JS v bloku.
Prevedene datoteke bodo shranjene v mapi _dist bloka in dodane v čakalno vrsto, ko bo blok uporabljen. Ko se izvorna datoteka posodobi, Blockstudio preveri, ali obstaja prevedena datoteka s tem časovnim žigom; če je ni, jo ustvari.
Za ta namen se uporablja knjižnica pomanjševanja.
Pomanjševanje lahko omogočite z nastavitvijo assets/minify:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
Če sloge raje pišete v SCSS, lahko omogočite obdelavo SCSS:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
S tem boste omogočili obdelavo SCSS za datoteke .css.
Lahko pa uporabite razširitev .scss; slogi bodo obdelani samodejno, tudi če zgornja nastavitev ni true.
Poti uvozov
Pri uporabi SCSS je mogoče uvoziti druge datoteke SCSS. Uvozi so določeni relativno glede na datoteko, iz katere se uvažajo.
@import "modules.scss";
Poleg tega lahko s filtrom blockstudio/assets/process/scss/import_paths določite poti uvozov po meri, tako da lahko uvažate datoteke iz drugih map, ne da bi navedli strukturo map.
Pri uvozih lahko izpustite končnico .scss, razrešijo pa se tudi delne datoteke, kot je _tokens.scss, ali datoteka _index.scss v mapi.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
Uvodna koda
Če želite imeti skupne funkcije Sass, spremenljivke, mešalnike ali pripomočke na voljo v vsaki datoteki SCSS, lahko pred prevajanjem dodate globalno uvodno kodo.
To je uporabno pri ogrodjih, kot je Bootstrap, kjer želite dostopati do skupnih mešalnikov, na primer prelomnih točk, ne da bi morali ponavljati uvoze v vsakem sredstvu bloka.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
V kombinaciji z blockstudio/assets/process/scss/import_paths je tako površina Sass, na katero se sklicujete, na voljo vsem prevedenim datotekam.
Sredstva blokov se znova prevedejo, ko se spremeni čas zadnje spremembe odvisnosti, tudi datotek, ki jih uvažajo druge delne datoteke. Blockstudio sledi lokalnim odvisnostim @import, @use in @forward, vključno z odvisnostmi uvodne kode in konfiguriranimi potmi uvozov. Skupne odvisnosti se spremljajo samo enkrat, cikli pa ne morejo povzročiti neskončnega iskanja. Te datoteke so vključene tudi na seznam datotek, ki jih spremlja predpomnilnik med izvajanjem.
Če na primer uredite mixins/_wysiwyg.scss, se global-styles.scss znova prevede, kadar uvaža scss/_wysiwyg.scss, ki nato uvaža ta mešalnik. Spremembam ni treba slediti z urejanjem vstopne datoteke. Vgrajeni moduli Sass in oddaljeni uvozi so izključeni iz lokalnega grafa odvisnosti.
Moduli ES
Vsi skripti v Blockstudio (vstavljeni in privzeti) se privzeto naložijo z omogočenim type="module". Zato lahko v skriptih svojih blokov uporabite sintakso uvoza brez dodatnih nastavitev.
Opomba
Za podrobnejši pregled modulov ES obiščite spletno dokumentacijo MDN.
Predstavljajmo si naslednjo kodo znotraj 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")
);
Zgornji primer ustvari komponento z uporabo Preact ter uvozi vse potrebne komponente in funkcije iz paketa CDN, združljivega z ESM; v tem primeru esm.sh. Ta pristop je povsem ustrezen, vendar je treba zahtevati potrebna sredstva z zunanjega spletnega mesta, zato lahko skripti prenehajo delovati, če CDN ni na voljo.
Blockstudio ponuja priročen način za prenos modulov ES v blok, zato med uporabo v produkciji ne potrebujete zunanjih CDN-jev za ESM.
Nastavitev
Če želite modul prenesti v mapo bloka, uporabite predpono npm:, ki ji sledita ime paketa in različica:
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";
Ta sintaksa sledi dogovoru Deno za določanje npm.
Opomba
Zastarela predpona
blockstudio/(e.g.,blockstudio/preact@10.15.1) je zaradi združljivosti s starejšimi različicami še vedno podprta, vendar za nove projekte priporočamo predpononpm:. Podrobnosti so v vodniku za prehod.
Blockstudio bo samodejno preveril spremenjene datoteke .js glede uvozov in jih prenesel v lokalno mapo bloka. Prenesene datoteke bodo shranjene v mapi modules znotraj mape bloka.
Ob shranjevanju bo skriptna datoteka prepisana, da bo uporabljala lokalno gostovani modul:
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";
V urejevalniku se bo za predogled in delo z blokom še vedno uporabljal URL CDN (uporablja Blockstudio esm.sh).
Omejitve
Različica
Običajno je mogoče module uporabljati prek CDN-jev brez številke različice. V tem primeru se vedno uporabi najnovejša različica. Ker Blockstudio v zbirko podatkov ne shranjuje nobenih podatkov, je pri uporabi modulov številka različice obvezna.
Isti moduli
Moduli so omejeni na svoje bloke. Tudi če v več blokih uporabite isti modul z isto številko različice, bo Blockstudio zahtevani modul še vedno prenesel v vsak blok. To je predvsem zato, ker naj bi bili bloki samostojne enote, ki jih je mogoče preprosto deliti z drugimi namestitvami ali spletnimi mesti.
Poleg tega bo isti modul zahtevan dvakrat, če sta na strani prisotna oba bloka. To težavo lahko rešite z uporabo script-inline.js namesto datoteke script.js. Blockstudio bo vsak uvoz preusmeril na mesto prvega pojava modula, če sta ime in številka različice enaka.
Nalagalnik CSS
Datoteke CSS je mogoče uvoziti tudi z enako sintakso kot zgoraj.
import "npm:swiper@11.0.0/swiper.min.css";
Datoteka CSS bo prenesena v mapo modules in samodejno dodana v čakalno vrsto, ko bo blok uporabljen. Če je različica enaka, bo v čakalno vrsto dodana samo ena različica datoteke CSS, tudi če je prisotna v več blokih.