Spracovanie zdrojových súborov
Minifikácia
Blockstudio dokáže automaticky minifikovať všetky súbory CSS a JS v bloku.
Skompilované súbory sa uložia do priečinka _dist bloku a pri použití bloku sa zaradia do frontu. Po aktualizácii zdrojového súboru Blockstudio skontroluje, či existuje skompilovaný súbor s rovnakou časovou pečiatkou; ak nie, vytvorí ho.
Na tento účel sa používa knižnica minify.
Minifikáciu možno zapnúť pomocou nastavenia assets/minify:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
Ak uprednostňujete písanie štýlov v SCSS, môžete zapnúť spracovanie SCSS:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
Tým sa zapne spracovanie SCSS pre súbory .css.
Môžete tiež použiť rozšírenie .scss a štýly sa budú spracúvať automaticky, aj keď vyššie uvedené nastavenie nie je true.
Cesty k importom
Pri používaní SCSS možno importovať aj ďalšie súbory SCSS. Importy sa vzťahujú na súbor, z ktorého sa importujú.
@import "modules.scss";
Okrem toho možno pomocou filtra blockstudio/assets/process/scss/import_paths definovať vlastné cesty k importom, takže súbory možno importovať z iných priečinkov bez zadávania štruktúry priečinkov.
Pri importe možno vynechať príponu .scss a rozpoznať čiastkové súbory, napríklad _tokens.scss, alebo súbor _index.scss v priečinku.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
Predbežný kód
Ak chcete, aby boli spoločné funkcie, premenné, mixiny alebo pomocné nástroje Sass dostupné v každom súbore SCSS, môžete pred kompiláciu pripojiť globálny predbežný kód.
Je to užitočné pri frameworkoch, ako je Bootstrap, keď chcete mať prístup k spoločným mixinom, napríklad k bodom zlomu, bez opakovaného importovania v každom zdrojovom súbore bloku.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
V kombinácii s blockstudio/assets/process/scss/import_paths sa tak vo všetkých skompilovaných súboroch sprístupní uvedené rozhranie Sass.
Zdrojové súbory blokov sa skompilujú znova, keď sa zmení čas úpravy závislosti, vrátane súborov importovaných inými čiastkovými súbormi. Blockstudio sleduje lokálne závislosti @import, @use a @forward vrátane závislostí predbežného kódu a nakonfigurovaných ciest importov. Spoločné závislosti sa sledujú iba raz a cykly nemôžu pri vyhľadávaní pokračovať donekonečna. Tieto súbory sa tiež pridávajú do zoznamu sledovaných súborov vyrovnávacej pamäte runtime.
Napríklad úprava súboru mixins/_wysiwyg.scss znova skompiluje súbor global-styles.scss, ak importuje scss/_wysiwyg.scss, ktorý následne importuje daný mixin. Zmeny nevyžadujú úpravu vstupného súboru. Vstavané moduly Sass a vzdialené importy sú z grafu lokálnych závislostí vylúčené.
Moduly ES
Všetky skripty (vložené aj predvolené) v Blockstudio sa predvolene načítajú s nastaveným type="module". To znamená, že v skriptoch svojich blokov môžete bez ďalšej konfigurácie používať syntax importu.
Poznámka
Podrobnejšie informácie o moduloch ES nájdete v webovej dokumentácii MDN.
Predstavme si nasledujúci kód v rámci 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")
);
Vyššie uvedený príklad by vytvoril komponent pomocou Preact a importoval všetky potrebné komponenty a funkcie z CDN kompatibilného s ESM, v tomto prípade esm.sh. Na tomto prístupe nie je nič zlé, jeho nevýhodou však je, že potrebné zdrojové súbory sa musia načítavať z externej stránky. Ak je CDN nedostupné, skripty môžu prestať fungovať.
Blockstudio ponúka praktický spôsob, ako stiahnuť moduly ES do bloku, takže pri nasadení už nie sú potrebné externé CDN pre ESM.
Nastavenie
Ak chcete stiahnuť modul do priečinka bloku, použite predponu npm:, za ktorou nasleduje názov a verzia balíka:
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";
Táto syntax zodpovedá konvencii Deno pre npmšpecifikátor.
Poznámka
Z dôvodu spätnej kompatibility sa stále podporuje staršia predpona
blockstudio/(e.g.,blockstudio/preact@10.15.1), ale v nových projektoch odporúčame používať predponunpm:. Podrobnosti nájdete v sprievodcovi migráciou.
Blockstudio automaticky skontroluje zmenené súbory .js, vyhľadá v nich importy a stiahne ich do lokálneho priečinka bloku. Stiahnuté súbory sa uložia do priečinka modules v priečinku bloku.
Pri uložení sa súbor skriptu prepíše tak, aby používal lokálne 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 editore sa pri náhľade a práci s blokom stále použije adresa URL CDN (Blockstudio používa esm.sh).
Upozornenia
Verzia
Moduly možno zvyčajne používať z CDN aj bez čísla verzie. V takom prípade sa vždy použije najnovšia verzia. Keďže Blockstudio neukladá žiadne informácie do databázy, pri používaní modulov je potrebné uviesť číslo verzie.
Rovnaké moduly
Moduly sú vyhradené pre svoje bloky. Aj keď v niekoľkých blokoch použijete rovnaký modul s rovnakým číslom verzie, Blockstudio aj tak stiahne požadovaný modul do každého bloku. Je to najmä preto, že bloky majú byť samostatné jednotky, ktoré možno jednoducho zdieľať medzi rôznymi inštaláciami alebo webmi.
Navyše sa ten istý modul vyžiada dvakrát, ak sú na stránke prítomné oba bloky. Tento problém možno vyriešiť použitím script-inline.js namiesto súboru script.js. Blockstudio prepíše každý import tak, aby odkazoval na umiestnenie prvého výskytu modulu, ak sa jeho názov a číslo verzie zhodujú.
Načítač CSS
Súbory CSS možno importovať aj pomocou rovnakej syntaxe ako vyššie.
import "npm:swiper@11.0.0/swiper.min.css";
Súbor CSS sa stiahne do priečinka modules a pri použití bloku sa automaticky zaradí do frontu. Ak je verzia rovnaká, do frontu sa zaradí iba jedna verzia súboru CSS, aj keď sa nachádza vo viacerých blokoch.