Zpracování prostředků
Minifikace
Blockstudio dokáže automaticky minifikovat všechny soubory CSS a JS v bloku.
Zkompilované soubory se uloží do složky _dist bloku a při jeho použití se zařadí do fronty. Při aktualizaci zdrojového souboru Blockstudio ověří, zda existuje zkompilovaný soubor s odpovídajícím časovým razítkem; pokud ne, vytvoří ho.
K tomuto účelu se používá knihovna minify.
Minifikaci lze zapnout pomocí nastavení assets/minify:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
Pokud dáváte přednost psaní stylů v SCSS, můžete zapnout zpracování SCSS:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
Tím se zapne zpracování SCSS pro soubory .css.
Případně můžete použít příponu .scss a styly se budou zpracovávat automaticky, i když výše uvedené nastavení není true.
Cesty importů
Při použití SCSS lze importovat další soubory SCSS. Importy se vztahují k souboru, ze kterého se importují.
@import "modules.scss";
Pomocí filtru blockstudio/assets/process/scss/import_paths lze také definovat vlastní cesty importů, takže můžete importovat soubory z jiných adresářů bez zadávání jejich struktury.
U importů lze vynechat příponu .scss a použít částečné cesty, například _tokens.scss nebo _index.scss adresáře.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
Předřazený kód
Chcete-li mít ve všech souborech SCSS k dispozici sdílené funkce, proměnné, mixiny nebo nástroje Sass, můžete před kompilaci vložit globální předřazený kód.
Hodí se to u frameworků, jako je Bootstrap, kde chcete mít přístup ke sdíleným mixinům, například pro breakpointy, aniž byste museli opakovat importy v každém prostředku bloku.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
V kombinaci s blockstudio/assets/process/scss/import_paths to zpřístupní odkazovaný povrch Sass v každém kompilovaném souboru.
Prostředky bloku se znovu kompilují, když se změní čas poslední úpravy závislosti, včetně souborů importovaných jinými částečnými soubory. Blockstudio sleduje místní závislosti @import, @use a @forward, včetně závislostí předřazeného kódu a nakonfigurovaných cest importů. Sdílené závislosti se sledují pouze jednou a při jejich zjišťování nemohou cykly způsobit nekonečnou smyčku. Tyto soubory jsou také zahrnuty do seznamu sledovaných souborů mezipaměti za běhu.
Například úpravou mixins/_wysiwyg.scss se znovu zkompiluje global-styles.scss, pokud importuje scss/_wysiwyg.scss, který následně importuje daný mixin. Změny nevyžadují úpravu vstupního souboru. Vestavěné moduly Sass a vzdálené importy jsou z grafu místních závislostí vyloučeny.
Moduly ES
Všechny skripty v Blockstudio, vložené i výchozí, se ve výchozím nastavení načítají s aktivovaným type="module". Ve skriptech bloků tak můžete používat syntaxi import bez dalšího nastavování.
Poznámka
Podrobnější informace o modulech ES najdete v dokumentaci MDN.
Představme si následující kód uvnitř 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")
);
Výše uvedený příklad by vytvořil komponentu pomocí Preact a importoval všechny potřebné komponenty a funkce z balíčku CDN kompatibilního s ESM, v tomto případě esm.sh. Na tomto přístupu není nic špatného, jeho nevýhodou však je nutnost načítat potřebné prostředky z externího webu. Pokud je CDN nedostupné, skripty mohou přestat fungovat.
Blockstudio nabízí praktický způsob, jak stáhnout moduly ES do bloku a při nasazení se tak obejít bez externích CDN pro ESM.
Nastavení
Chcete-li stáhnout modul do adresáře bloku, použijte předponu npm:, za níž následuje název a verze balíčku:
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";
Tato syntaxe odpovídá konvenci specifikátoru Deno npm specifier.
Poznámka
Starší předpona
blockstudio/(e.g,blockstudio/preact@10.15.1) je kvůli zpětné kompatibilitě stále podporována, ale pro nové projekty doporučujeme používat předponunpm:. Podrobnosti najdete v průvodci migrací.
Blockstudio automaticky kontroluje změněné soubory .js, vyhledá v nich importy a stáhne je do místního adresáře bloku. Stažené soubory se umístí do složky modules v adresáři bloku.
Při uložení se soubor skriptu přepíše tak, aby používal místně hostovaný 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";
V editoru se při náhledu a práci s blokem stále používá adresa URL CDN (Blockstudio používá esm.sh).
Omezení
Verze
Moduly lze obvykle používat z CDN bez čísla verze. V takovém případě se vždy použije nejnovější verze. Protože Blockstudio neukládá žádné informace do databáze, je při používání modulů nutné uvést číslo verze.
Stejné moduly
Moduly jsou vázané na své bloky. I když použijete stejný modul se stejným číslem verze ve více blocích, Blockstudio přesto požadovaný modul stáhne do každého bloku. Důvodem je především to, že bloky mají být samostatné jednotky, které lze snadno sdílet mezi různými instalacemi nebo weby.
Navíc se stejný modul načte dvakrát, pokud jsou na stránce přítomny oba bloky. Tento problém lze vyřešit použitím script-inline.js místo souboru script.js. Blockstudio přepíše každý import tak, aby odkazoval na umístění prvního výskytu modulu, pokud se jeho název i verze shodují.
Načítání CSS
Stejnou syntaxí jako výše lze importovat také soubory CSS.
import "npm:swiper@11.0.0/swiper.min.css";
Soubor CSS se stáhne do složky modules a při použití bloku se automaticky zařadí do fronty. Pokud je verze stejná, do fronty se zařadí pouze jedna verze souboru CSS, i když se nachází ve více blocích.