Varade töötlemine
Minimeerimine
Blockstudio suudab plokis automaatselt minimeerida kõiki CSS- ja JS-faile.
Kompileeritud failid salvestatakse ploki kausta _dist ja lisatakse järjekorda, kui plokki kasutatakse. Lähtefaili uuendamisel kontrollib Blockstudio, kas sama ajatempliga kompileeritud fail on olemas; kui pole, luuakse see.
Selleks kasutatakse teeki minify.
Minimeerimise saab lubada seadega assets/minify:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
Kui eelistate kirjutada stiile keeles SCSS, saate lubada töötlemise SCSS:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
See lubab failide .css töötlemise SCSS.
Teise võimalusena saate kasutada laiendit .scss, mille korral töödeldakse stiile automaatselt ka siis, kui ülaltoodud seade pole true.
Imporditeed
SCSS kasutamisel saab importida teisi SCSS-faile. Imporditeed on suhtelised faili suhtes, millest neid imporditakse.
@import "modules.scss";
Lisaks saab filtriga blockstudio/assets/process/scss/import_paths määrata kohandatud imporditeid, et faile saaks importida teistest kataloogidest ilma kaustastruktuuri määramata.
Importimisel võib laiendi .scss ära jätta ning resolve’ida osalisi, näiteks _tokens.scss, või kataloogi _index.scss.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
Eellõik
Kui soovite, et jagatud Sass funktsioonid, muutujad, miksinid või utiliidid oleksid saadaval igas SCSS-failis, saate enne kompileerimist lisada globaalse eellõigu.
See on kasulik raamistike (nt Bootstrap) puhul, kui soovite kasutada jagatud miksineid, näiteks murdepunktide jaoks, ilma et peaksite importimist igas plokivaras kordama.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
Koos blockstudio/assets/process/scss/import_paths-ga teeb see viidatud Sass-pinna kõigile kompileeritud failidele kättesaadavaks.
Ploki varad kompileeritakse uuesti, kui sõltuvuse muutmisaeg muutub, sealhulgas failidel, mida impordivad teised osalised failid. Blockstudio jälgib kohalikke @import, @use ja @forward sõltuvusi, sealhulgas eellõigu sõltuvusi ja seadistatud imporditeid. Jagatud sõltuvusi jälgitakse üks kord ning tsüklid ei saa avastamise ajal lõputult korduda. Need failid lisatakse ka käitusaja vahemälu jälgimisloendisse.
Näiteks faili mixins/_wysiwyg.scss muutmine kompileerib uuesti faili global-styles.scss, kui see impordib scss/_wysiwyg.scss, mis omakorda impordib selle miksini. Muudatuste tegemiseks pole vaja sisendfaili puutuda. Sass sisseehitatud moodulid ja kaugimpordid jäetakse kohalike sõltuvuste graafist välja.
ES-moodulid
Kõik Blockstudio skriptid (nii tekstisisesed kui ka vaikimisi skriptid) laaditakse vaikimisi, neile on rakendatud type="module". See tähendab, et plokkide skriptides saab ilma lisaseadistusteta kasutada impordisüntaksit.
Märkus
ES-moodulite kohta põhjalikuma ülevaate saamiseks vaadake MDN-i veebidokumentatsiooni.
Kujutame ette järgmist koodi script.js sees:
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")
);
Ülaltoodud näide looks komponendi, kasutades Preact, ning impordiks kõik vajalikud komponendid ja funktsioonid ESM-iga ühilduvast CDN-ist, antud juhul esm.sh. See lähenemine on täiesti sobiv, kuid selle puuduseks on vajadus laadida vajalikud varad väliselt saidilt, mistõttu võivad skriptid lakata töötamast, kui CDN pole saadaval.
Blockstudio võimaldab mugavalt laadida ES-mooduleid plokki, nii et tootmiskeskkonnas pole vaja kasutada väliseid ESM CDN-e.
Seadistamine
Mooduli plokikataloogi laadimiseks kasutage prefiksit npm:, millele järgneb paketi nimi ja versioon:
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";
See süntaks järgib Deno npm spetsifikaatori kokkulepet.
Märkus
Pärandprefiks
blockstudio/(e.g,blockstudio/preact@10.15.1) on tagasiühilduvuse huvides endiselt toetatud, kuid uute projektide puhul soovitame kasutada prefiksitnpm:. Lisateavet leiate migratsioonijuhendist.
Blockstudio kontrollib muudetud .js-faile automaatselt impordite olemasolu suhtes ja laadib need ploki kohalikku kataloogi. Allalaaditud failid paigutatakse plokikataloogis kausta modules.
Salvestamisel kirjutatakse skriptifail ümber, et see kasutaks kohalikku moodulit:
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";
Redaktoris kasutatakse ploki eelvaates ja sellega töötamisel endiselt URL-i CDN (Blockstudio kasutab esm.sh).
Piirangud
Versioon
Tavaliselt saab mooduleid CDN-idest kasutada versiooninumbrita. Sel juhul kasutatakse alati uusimat versiooni. Kuna Blockstudio ei salvesta andmebaasi teavet, on moodulite kasutamisel versiooninumber nõutav.
Samad moodulid
Moodulid kuuluvad konkreetsetele plokkidele. Isegi kui kasutate sama moodulit sama versiooninumbriga mitmes plokis, laadib Blockstudio soovitud mooduli ikkagi iga ploki juurde eraldi. Seda peamiselt seetõttu, et plokid peaksid olema iseseisvad üksused, mida saab hõlpsasti teiste installatsioonide või saitide vahel jagada.
Lisaks laaditakse sama moodulit kaks korda, kui lehel on mõlemad plokid. Selle probleemi saab lahendada, kasutades faili script-inline.js faili script.js asemel. Blockstudio muudab iga impordi viitama mooduli esimesele asukohale, kui nimi ja versiooninumber on samad.
CSS laadija
Samuti saab importida CSS-faile, kasutades ülaltoodud süntaksit.
import "npm:swiper@11.0.0/swiper.min.css";
CSS fail laaditakse kausta modules ja lisatakse automaatselt järjekorda, kui plokki kasutatakse. Kui versioon on sama, lisatakse fail CSS järjekorda ainult üks kord, isegi kui see on olemas mitmes plokis.