Behandling af aktiver
Minificering
Blockstudio kan automatisk minificere alle CSS- og JS-filer i en blok.
Kompilerede filer gemmes i blokkens mappe _dist og tilføjes til køen, når en blok bruges. Når kildefilen opdateres, kontrollerer Blockstudio, om der findes en kompileret fil med samme tidsstempel. Hvis ikke, oprettes den.
Biblioteket minify bruges til dette.
Minificering kan aktiveres med indstillingen assets/minify:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
Hvis du foretrækker at skrive dine typografier i SCSS, kan du aktivere behandling af SCSS:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
Dette aktiverer behandling af SCSS for .css-filer.
Du kan også bruge udvidelsen .scss, så behandles typografier automatisk, selv når indstillingen ovenfor ikke er true.
Importstier
Når du bruger SCSS, kan du importere andre SCSS-filer. Importer er relative til den fil, de importeres fra.
@import "modules.scss";
Derudover kan du definere brugerdefinerede importstier med filteret blockstudio/assets/process/scss/import_paths, så filer kan importeres fra andre mapper uden at angive mappestrukturen.
Du kan udelade filtypen .scss ved import, og importen finder også partielle filer som _tokens.scss eller en mappes _index.scss.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
Forudgående kode
Hvis du vil have fællesfunktioner, variabler, mixins eller værktøjer fra Sass tilgængelige i hver SCSS-fil, kan du indsætte en global forudgående kode før kompileringen.
Dette er nyttigt for frameworks som Bootstrap, hvor du måske vil have adgang til fælles mixins som breakpoints uden at gentage importer i hvert blokaktiv.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
Kombineret med blockstudio/assets/process/scss/import_paths gør dette den
refererede Sass-overflade tilgængelig i alle kompilerede filer.
Blokaktiver kompileres igen, når en afhængigheds ændringstidspunkt ændres, herunder filer importeret af andre partielle filer. Blockstudio følger lokale afhængigheder af @import, @use og @forward, herunder afhængigheder fra forudgående kode og konfigurerede importstier. Fælles afhængigheder registreres én gang, og cyklusser kan ikke føre til uendelig søgning. Disse filer føjes også til overvågningslisten for runtime-cachen.
Hvis du for eksempel redigerer mixins/_wysiwyg.scss, kompileres global-styles.scss igen, når den importerer scss/_wysiwyg.scss, som igen importerer dette mixin. Ændringer kræver ikke, at du rører ved entry-filen. Indbyggede Sass-moduler og fjernimporter udelades fra den lokale afhængighedsgraf.
ES-moduler
Alle scripts (inline og standard) i Blockstudio indlæses som standard med type="module" anvendt. Det betyder, at du kan bruge imports i dine blokkes scripts uden yderligere opsætning.
Bemærk
Se MDN’s webdokumentation for en mere dybdegående gennemgang af ES-moduler.
Lad os forestille os følgende kode 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")
);
Eksemplet ovenfor opretter en komponent med Preact og importerer alle nødvendige komponenter og funktioner fra en ESM-kompatibel CDN, i dette tilfælde esm.sh. Der er ikke noget galt med denne tilgang, men den kræver, at de nødvendige aktiver hentes fra et eksternt websted. Hvis CDN er nede, kan scripts derfor gå i stykker.
Blockstudio gør det nemt at downloade ES-moduler til blokken, så du ikke behøver eksterne ESM-CDN’er i produktion.
Opsætning
Hvis du vil downloade et modul til blokkens mappe, skal du bruge præfikset npm: efterfulgt af pakkenavnet og versionen:
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";
Denne syntaks stemmer overens med Denos npm-konvention for specifikatoren.
Bemærk
Det ældre præfiks
blockstudio/(e.g.,blockstudio/preact@10.15.1) understøttes stadig af hensyn til bagudkompatibilitet, men vi anbefaler at bruge præfiksetnpm:i nye projekter. Se migreringsvejledningen for detaljer.
Blockstudio tjekker automatisk ændrede .js-filer for importer og downloader dem til den lokale blokmappe. De downloadede filer placeres i en mappe modules i blokmappen.
Når scripts gemmes, omskrives de, så de bruger det lokalt hostede 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";
I editoren bruges URL’en CDN stadig (Blockstudio bruger esm.sh), når du forhåndsviser og arbejder på blokken.
Forbehold
Version
Normalt kan moduler bruges fra CDN’er uden versionsnummer. I så fald bruges altid den nyeste version. Da Blockstudio ikke gemmer oplysninger i databasen, kræves et versionsnummer, når du bruger moduler.
Samme moduler
Moduler er knyttet til deres blokke. Selv hvis du bruger samme modul med samme versionsnummer i flere blokke, downloader Blockstudio stadig det ønskede modul til blokken. Det skyldes især, at blokke bør være selvstændige enheder, som nemt kan deles på tværs af installationer og websteder.
Desuden hentes det samme modul to gange, hvis begge blokke findes på en side. Det kan løses ved at bruge script-inline.js i stedet for filen script.js. Blockstudio omskriver hver import, så den peger på placeringen af modulets første forekomst, hvis navn og versionsnummer er ens.
CSS-indlæser
Det er også muligt at importere CSS-filer med samme syntaks som ovenfor.
import "npm:swiper@11.0.0/swiper.min.css";
Filen CSS downloades til mappen modules og føjes automatisk til køen, når blokken bruges. Så længe versionen er den samme, føjes kun én version af filen CSS til køen, selv hvis den findes i flere blokke.