Eszközök feldolgozása
Tömörítés
A Blockstudio automatikusan tömöríti egy blokk összes CSS és JS fájlját.
A lefordított fájlok a blokk _dist mappájába kerülnek, és a blokk használatakor töltődnek be. A forrásfájl frissítésekor a Blockstudio ellenőrzi, hogy létezik-e az adott időbélyeggel lefordított fájl; ha nem, létrehozza.
Ehhez a minify könyvtárat használja.
A tömörítést a assets/minify beállítással engedélyezheti:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
Ha inkább SCSS nyelven írná a stílusokat, engedélyezheti a SCSS feldolgozását:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
Ez engedélyezi a SCSS feldolgozását a .css fájlokhoz.
Másik lehetőségként használhatja a .scss kiterjesztést; ekkor a stílusok automatikusan feldolgozásra kerülnek akkor is, ha a fenti beállítás nincs true állapotban.
Importálási útvonalak
SCSS használatakor más SCSS fájlok is importálhatók. Az importálási útvonalak az importáló fájlhoz képest relatívak.
@import "modules.scss";
Ezenkívül egyéni importálási útvonalakat is megadhat a blockstudio/assets/process/scss/import_paths szűrővel, így más könyvtárakból is importálhat fájlokat a mappaszerkezet megadása nélkül.
Az importoknál elhagyható a .scss kiterjesztés, és a rendszer feloldja a részfájlokat, például a _tokens.scss fájlt vagy egy könyvtár _index.scss fájlját.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
Előzetes kód
Ha azt szeretné, hogy megosztott Sass függvények, változók, mixinek vagy segédprogramok minden SCSS fájlban rendelkezésre álljanak, a fordítás előtt globális előzetes kódot illeszthet be.
Ez olyan keretrendszereknél hasznos, mint a Bootstrap, ahol minden blokk eszközébe történő ismételt importálás nélkül szeretne hozzáférni a megosztott mixinekhez, például a töréspontokhoz.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
A blockstudio/assets/process/scss/import_paths használatával együtt ez minden lefordított fájlban elérhetővé teszi a hivatkozott Sass felületet.
A blokk eszközei újrafordulnak, ha megváltozik valamely függőség módosítási ideje, beleértve a más részfájlok által importált fájlokat is. A Blockstudio követi a helyi @import, @use és @forward függőségeket, beleértve az előzetes kód függőségeit és a beállított importálási útvonalakat. A megosztott függőségeket egyszer követi nyomon, a ciklusok pedig nem okozhatnak végtelen keresést. Ezek a fájlok a futásidejű gyorsítótár figyelési listájára is felkerülnek.
Például a mixins/_wysiwyg.scss szerkesztése újrafordítja a global-styles.scss fájlt, ha az importálja a scss/_wysiwyg.scss fájlt, amely viszont importálja ezt a mixint. A módosításokhoz nem kell megérinteni a belépési fájlt. A Sass beépített moduljai és a távoli importok nem részei a helyi függőségi gráfnak.
ES-modulok
A Blockstudio összes szkriptje (az inline és az alapértelmezett is) alapértelmezés szerint type="module" beállítással töltődik be. Így a blokkok szkriptjeiben további beállítás nélkül használhatja az import szintaxist.
Megjegyzés
Az ES-modulok részletesebb ismertetéséért keresse fel az MDN webes dokumentációját.
Képzeljük el a következő kódot egy script.js belsejében:
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")
);
A fenti példa egy komponenst hozna létre a Preact használatával; az összes szükséges komponenst és függvényt egy ESM-kompatibilis CDN csomagból importálná, jelen esetben a esm.sh csomagból. Ezzel a megközelítéssel nincs semmi gond, hátránya viszont, hogy a szükséges eszközöket külső webhelyről kell lekérni, így ha a CDN nem működik, a szkriptek is meghibásodhatnak.
A Blockstudio kényelmes megoldást kínál az ES-modulok blokkba történő letöltésére, így éles környezetben nincs szükség külső ESM CDN-ekre.
Beállítás
Modul blokk könyvtárába való letöltéséhez használja a npm: előtagot, majd adja meg a csomag nevét és verzióját:
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";
Ez a szintaxis megfelel a Deno npm specifikáló konvenciójának.
Megjegyzés
A régi
blockstudio/előtag (e.g,blockstudio/preact@10.15.1) továbbra is támogatott a visszamenőleges kompatibilitás érdekében, de új projekteknél anpm:előtag használatát javasoljuk. A részletekért tekintse meg az átállási útmutatót.
A Blockstudio automatikusan megkeresi a módosított .js fájlok importjait, és letölti azokat a blokk helyi könyvtárába. A letöltött fájlok a blokk könyvtárának modules mappájába kerülnek.
Mentéskor a szkriptfájl átíródik, hogy a helyben tárolt modult használja:
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";
A szerkesztőben a blokk előnézetekor és szerkesztésekor továbbra is a CDN URL lesz használatban (a Blockstudio a esm.sh segítségével működik).
Korlátozások
Verzió
A modulok általában verziószám nélkül is használhatók CDN-ekről. Ilyenkor mindig a legújabb verzió töltődik be. Mivel a Blockstudio nem ment adatokat az adatbázisba, a modulok használatához meg kell adni a verziószámot.
Azonos modulok
A modulok a blokkjukhoz vannak kötve. Még akkor is, ha több blokkban ugyanazt a modult, ugyanazzal a verziószámmal használja, a Blockstudio külön letölti a modult az adott blokkhoz. Ennek fő oka, hogy a blokkok önálló egységek legyenek, amelyeket könnyen meg lehet osztani más telepítésekkel és webhelyekkel.
Ráadásul ugyanazt a modult kétszer kéri le a rendszer, ha mindkét blokk szerepel az oldalon. Ez a probléma úgy oldható meg, hogy a script-inline.js fájlt használja a script.js fájl helyett. A Blockstudio minden importot átír úgy, hogy az elsőként előforduló modul helyére mutasson, ha a név és a verziószám azonos.
CSS betöltő
A fenti szintaxissal CSS fájlok is importálhatók.
import "npm:swiper@11.0.0/swiper.min.css";
A CSS fájl a modules mappába kerül, és a blokk használatakor automatikusan betöltődik. Amíg a verzió azonos, a rendszer csak egyetlen CSS fájlt tölt be akkor is, ha az több blokkban is megtalálható.