Bearbeta tillgångar
Minifiering
Blockstudio kan automatiskt minifiera alla CSS- och JS-filer i ett block.
Kompilerade filer sparas i blockets mapp _dist och läggs i kön när ett block används. När källfilen uppdateras kontrollerar Blockstudio om det finns en kompilerad fil med samma tidsstämpel. Om inte skapas en ny fil.
Biblioteket minify används för detta.
Minifiering kan aktiveras med inställningen assets/minify:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
Om du föredrar att skriva dina stilar i SCSS kan du aktivera bearbetning av SCSS:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
Då aktiveras bearbetning av SCSS-filer för .css.
Du kan också använda tillägget .scss, så bearbetas stilar automatiskt även när inställningen ovan inte är true.
Importsökvägar
När du använder SCSS kan du importera andra SCSS-filer. Importerna är relativa till filen de importeras från.
@import "modules.scss";
Du kan också ange egna importsökvägar med filtret blockstudio/assets/process/scss/import_paths, så att filer kan importeras från andra kataloger utan att du behöver ange någon mappstruktur.
Vid importer kan tillägget .scss utelämnas. Sökvägen kan även avse partialer som _tokens.scss eller en katalogs _index.scss.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
Förtext
Om du vill ha tillgång till gemensamma funktioner, variabler, mixins eller verktyg i Sass varje SCSS-fil kan du lägga till en global förtext före kompileringen.
Detta är användbart för ramverk som Bootstrap, där du kanske vill använda gemensamma mixins, till exempel brytpunkter, utan att upprepa importer i varje blocktillgång.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
Tillsammans med blockstudio/assets/process/scss/import_paths gör detta den
refererade ytan Sass tillgänglig i varje kompilerad fil.
Blocktillgångar kompileras om när en beroendefils ändringstid ändras, även för filer som importeras av andra partialer. Blockstudio följer lokala beroenden för @import, @use och @forward, inklusive förtextens beroenden och konfigurerade importsökvägar. Delade beroenden spåras en gång, och cykler kan inte orsaka oändliga loopar vid identifieringen. Dessa filer ingår också i listan över filer som bevakas av runtime-cachen.
Om du till exempel redigerar mixins/_wysiwyg.scss kompileras global-styles.scss om när den importerar scss/_wysiwyg.scss, som i sin tur importerar mixinen. Du behöver inte ändra startfilen. Sass inbyggda moduler och fjärrimporter ingår inte i den lokala beroendegrafen.
ES-moduler
Alla skript i Blockstudio, både infogade och standard, laddas som standard med type="module" aktiverat. Det betyder att du kan använda importsatsen i skripten för dina block utan ytterligare inställningar.
Obs!
Läs MDN:s webbdokumentation om du vill veta mer om ES-moduler.
Föreställ dig följande kod i en 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")
);
Exemplet ovan skapar en komponent med Preact och importerar alla nödvändiga komponenter och funktioner från ett CDN som är kompatibelt med ESM, i det här fallet esm.sh. Det är inget fel med detta tillvägagångssätt, men de nödvändiga tillgångarna måste hämtas från en extern webbplats. Om CDN ligger nere riskerar skripten därför att sluta fungera.
Blockstudio erbjuder ett smidigt sätt att ladda ned ES Modules till blocket, så att du slipper externa ESM CDN:er i produktionsmiljön.
Konfiguration
Ladda ned en modul till blockets katalog genom att använda prefixet npm: följt av paketnamn och version:
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";
Den här syntaxen följer Denos konvention för npmspecifierare.
Obs!
Det äldre prefixet
blockstudio/(e.g.,blockstudio/preact@10.15.1) stöds fortfarande för bakåtkompatibilitet, men för nya projekt rekommenderar vi prefixetnpm:. Mer information finns i migreringsguiden.
Blockstudio söker automatiskt efter importer i ändrade .js-filer och laddar ned dem till den lokala blockkatalogen. De nedladdade filerna placeras i en modules-mapp i blockkatalogen.
När du sparar skrivs skriptfilen om för att använda den lokalt lagrade modulen:
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";
I redigeraren används fortfarande CDN-URL:en (Blockstudio använder esm.sh) när du förhandsgranskar och arbetar med blocket.
Begränsningar
Version
Vanligtvis kan moduler hämtas från CDN:er utan versionsnummer. Då används alltid den senaste versionen. Eftersom Blockstudio inte sparar någon information i databasen krävs ett versionsnummer när moduler används.
Samma moduler
Moduler är avgränsade till sina block. Även om samma modul med samma versionsnummer används i flera block laddar Blockstudio ändå ned modulen som begärts till blocket. Det beror främst på att block bör vara fristående enheter som enkelt kan delas mellan olika installationer och webbplatser.
Dessutom begärs samma modul två gånger om båda blocken finns på en sida. Du kan lösa detta genom att använda script-inline.js i stället för filen script.js. Blockstudio skriver om varje import så att den pekar på platsen för modulens första förekomst, om namn och versionsnummer är desamma.
CSS-laddare
Du kan också importera CSS-filer med samma syntax som ovan.
import "npm:swiper@11.0.0/swiper.min.css";
Filen CSS laddas ned till mappen modules och läggs automatiskt i kön när blocket används. Så länge versionen är densamma läggs bara en version av filen CSS i kön, även om den finns i flera block.