Gå til indhold

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:

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

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

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

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

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

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

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:

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

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æfikset npm: 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:

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

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.

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