Ugrás a tartalomhoz

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:

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

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

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

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

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

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

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:

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

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 a npm: 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:

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

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.

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