Liigu sisu juurde

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:

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

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

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

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

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

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

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

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

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 prefiksit npm:. 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:

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

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.

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