Išteklių apdorojimas
Mažinimas
Blockstudio gali automatiškai sumažinti visus bloko CSS ir JS failus.
Sukompiliuoti failai išsaugomi bloko aplanke _dist ir įtraukiami į eilę, kai naudojamas blokas. Atnaujinus pradinį failą, Blockstudio patikrina, ar yra sukompiliuotas failas su atitinkama laiko žyma; jei nėra, jis sukuriamas.
Tam naudojama biblioteka minify.
Mažinimą galima įjungti naudojant nustatymą assets/minify:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
Jei stilius norite rašyti naudodami SCSS, galite įjungti SCSS apdorojimą:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
Taip bus įjungtas SCSS apdorojimas .css failams.
Arba galite naudoti plėtinį .scss, ir stiliai bus automatiškai apdorojami net tada, kai pirmiau pateiktas nustatymas nebus true.
Importavimo keliai
Naudojant SCSS, galima importuoti kitus SCSS failus. Importai apibrėžiami santykinai su failu, iš kurio jie importuojami.
@import "modules.scss";
Be to, pasirinktinius importavimo kelius galima apibrėžti naudojant filtrą blockstudio/assets/process/scss/import_paths, kad failus būtų galima importuoti iš kitų katalogų nenurodant aplankų struktūros.
Importuojant galima nenurodyti plėtinio .scss. Taip pat galima nurodyti dalinius failus, pavyzdžiui, _tokens.scss, arba katalogo _index.scss.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
Pradinis kodas
Jei norite, kad bendros Sass funkcijos, kintamieji, mišiniai ar įrankiai būtų pasiekiami kiekviename SCSS faile, prieš kompiliavimą galite pridėti visuotinį pradinį kodą.
Tai naudinga naudojant tokias sistemas kaip Bootstrap, kai norite turėti prieigą prie bendrų mišinių, pavyzdžiui, lūžio taškų, ir nekartoti importų kiekviename bloko ištekliuje.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
Kartu su blockstudio/assets/process/scss/import_paths tai leidžia kiekvienam kompiliuojamam failui naudoti nurodytą Sass paviršių.
Blokų ištekliai kompiliuojami iš naujo pasikeitus priklausomybės modifikavimo laikui, įskaitant failus, kuriuos importuoja kiti daliniai failai. Blockstudio seka vietines @import, @use ir @forward priklausomybes, įskaitant pradinio kodo priklausomybes ir sukonfigūruotus importavimo kelius. Bendros priklausomybės sekamos vieną kartą, o ciklai nesukelia begalinio tikrinimo. Šie failai taip pat įtraukiami į vykdymo aplinkos podėlio stebėjimo sąrašą.
Pavyzdžiui, redagavus mixins/_wysiwyg.scss, iš naujo kompiliuojamas global-styles.scss, jei jis importuoja scss/_wysiwyg.scss, kuriame importuojamas tas mišinys. Norint pritaikyti pakeitimus, įvesties failo keisti nereikia. Sass integruotieji moduliai ir nuotoliniai importai į vietinių priklausomybių grafiką neįtraukiami.
ES moduliai
Visi Blockstudio scenarijai (įterptieji ir numatytieji) pagal numatytuosius nustatymus įkeliami pritaikius type="module". Tai reiškia, kad savo blokų scenarijuose galite naudoti importo sintaksę be papildomos sąrankos.
Pastaba
Išsamiau apie ES modulius skaitykite MDN žiniatinklio dokumentacijoje.
Įsivaizduokime tokį kodą, esantį 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")
);
Aukščiau pateiktame pavyzdyje būtų sukurtas komponentas naudojant Preact, importuojant visus reikalingus komponentus ir funkcijas iš su ESM suderinamo CDN, šiuo atveju esm.sh. Šis būdas veikia, tačiau jo trūkumas tas, kad reikiamus išteklius reikia užklausti iš išorinės svetainės, todėl sutrikus CDN veikimui scenarijai gali nustoti veikti.
Blockstudio suteikia patogią galimybę atsisiųsti ES modulius į bloką, todėl gamybinėje aplinkoje nebereikia išorinių ESM CDN.
Sąranka
Norėdami atsisiųsti modulį į bloko katalogą, naudokite priešdėlį npm:, po kurio įrašykite paketo pavadinimą ir versiją:
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";
Ši sintaksė atitinka Deno specifikatoriaus npm naudojimo taisyklę.
Pastaba
Senasis priešdėlis
blockstudio/(e.g.,blockstudio/preact@10.15.1) vis dar palaikomas dėl atgalinio suderinamumo, tačiau naujiems projektams rekomenduojame naudoti priešdėlįnpm:. Daugiau informacijos rasite perėjimo vadove.
Blockstudio automatiškai patikrins pakeistus .js failus, ar juose yra importų, ir atsisiųs importuojamus modulius į vietinį bloko katalogą. Atsisiųsti failai bus patalpinti bloko katalogo aplanke modules.
Išsaugojus scenarijaus failą, jis bus perrašytas, kad naudotų vietinį 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";
Redaktoriuje peržiūrint bloką ir su juo dirbant vis tiek bus naudojamas CDN URL (Blockstudio naudoja esm.sh).
Apribojimai
Versija
Paprastai modulius galima naudoti iš CDN nenurodant versijos numerio. Tokiu atveju visada naudojama naujausia versija. Kadangi Blockstudio neišsaugo jokios informacijos duomenų bazėje, naudojant modulius būtina nurodyti versijos numerį.
Tie patys moduliai
Moduliai priskiriami konkretiems blokams. Net jei tą patį modulį su ta pačia versija naudojate keliuose blokuose, Blockstudio vis tiek atsisiųs prašomą modulį į kiekvieną bloką. Taip yra todėl, kad blokai turėtų būti savarankiški vienetai, kuriuos lengva bendrinti su kitomis instaliacijomis ar svetainėmis.
Be to, tas pats modulis bus užklaustas du kartus, jei puslapyje yra abu blokai. Šią problemą galima išspręsti naudojant script-inline.js failą vietoj script.js failo. Blockstudio perrašys kiekvieną importą taip, kad jis nurodytų pirmąją modulio vietą, jei jo pavadinimas ir versijos numeris sutampa.
CSS įkėliklis
CSS failus taip pat galima importuoti naudojant tą pačią sintaksę kaip pirmiau.
import "npm:swiper@11.0.0/swiper.min.css";
CSS failas bus atsisiųstas į aplanką modules ir automatiškai įtrauktas į eilę naudojant bloką. Jei versija sutampa, į eilę bus įtrauktas tik vienas CSS failas, net jei jis yra keliuose blokuose.