Siirry sisältöön

Resurssien käsittely

Pienennys

Blockstudio voi pienentää automaattisesti kaikki lohkon CSS- ja JS-tiedostot.

Käännetyt tiedostot tallennetaan lohkon _dist-kansioon ja lisätään jonoon, kun lohkoa käytetään. Kun lähdetiedosto päivitetään, Blockstudio tarkistaa, löytyykö aikaleimaa vastaava käännetty tiedosto. Jos ei, se luodaan.

Tähän käytetään minify-kirjastoa.

Pienennyksen voi ottaa käyttöön assets/minify-asetuksella:

PHP
add_filter('blockstudio/settings/assets/minify/css', function() {
  return true;
});

add_filter('blockstudio/settings/assets/minify/js', function() {
  return true;
});

SCSS

Jos kirjoitat tyylisi mieluummin SCSS-muodossa, voit ottaa käyttöön SCSS-käsittelyn:

PHP
add_filter('blockstudio/settings/assets/process/scss', function() {
  return true;
});

Tämä ottaa SCSS-käsittelyn käyttöön .css-tiedostoille.

Vaihtoehtoisesti voit käyttää .scss-laajennusta, jolloin tyylit käsitellään automaattisesti, vaikka yllä oleva asetus ei olisi true.

Tuontipolut

SCSS-tiedostoissa voi tuoda muita SCSS-tiedostoja. Tuonnit ovat suhteellisia siihen tiedostoon, josta ne tuodaan.

CSS
@import "modules.scss";

Lisäksi mukautetut tuontipolut voi määrittää blockstudio/assets/process/scss/import_paths-suodattimella, jolloin tiedostoja voi tuoda muista hakemistoista määrittämättä kansiorakennetta.

Tuonneissa voi jättää .scss-päätteen pois, ja ne löytävät osittaiset tiedostot, kuten _tokens.scss, tai hakemiston _index.scss-tiedoston.

PHP
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
  $paths[] = get_template_directory() . '/scss';
  return $paths;
});

Esiosa

Jos haluat, että jaetut Sass-funktiot, muuttujat, sekoitukset tai apuohjelmat ovat käytettävissä kaikissa SCSS-tiedostoissa, voit lisätä yleisen esiosan ennen käännöstä.

Tästä on hyötyä esimerkiksi Bootstrap-kehyksissä, joissa voit haluta käyttää jaettuja sekoituksia, kuten katkaisukohtia, toistamatta tuonteja jokaisessa lohkon resurssissa.

PHP
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
  return '@import "functions";' . "\n"
    . '@import "variables";' . "\n"
    . '@import "mixins";';
}, 10, 3);

Yhdessä blockstudio/assets/process/scss/import_paths-toiminnon kanssa tämä tuo viitatun Sass-rajapinnan kaikkien käännettyjen tiedostojen käyttöön.

Lohkojen resurssit käännetään uudelleen, kun riippuvuuden muokkausaika muuttuu. Tämä koskee myös muiden osittaistiedostojen tuomia tiedostoja. Blockstudio seuraa paikallisia @import-, @use– ja @forward-riippuvuuksia, mukaan lukien esiosan riippuvuudet ja määritetyt tuontipolut. Jaetut riippuvuudet seurataan vain kerran, eikä silmukoista synny päättymätöntä käsittelyä löytämisen aikana. Nämä tiedostot lisätään myös ajonaikaisen välimuistin valvontaluetteloon.

Jos esimerkiksi muokkaat tiedostoa mixins/_wysiwyg.scss, global-styles.scss käännetään uudelleen, kun se tuo tiedoston scss/_wysiwyg.scss, joka puolestaan tuo kyseisen sekoituksen. Muutokset eivät edellytä aloitustiedoston muokkaamista. Sass-sisäiset moduulit ja etätuonnit eivät kuulu paikalliseen riippuvuuskaavioon.

ES-moduulit

Kaikki Blockstudio-skriptit (sisäiset ja oletusarvoiset) latautuvat oletuksena niin, että niihin sovelletaan type="module". Näin voit käyttää lohkojesi skripteissä tuontisyntaksia ilman lisämäärityksiä.

Huomautus

Lisätietoja ES-moduuleista on MDN:n verkkodokumentaatiossa.

Kuvitellaanpa seuraava koodi script.js-tiedoston sisällä:

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

Yllä oleva esimerkki loisi komponentin käyttämällä Preact-kirjastoa ja tuomalla kaikki tarvittavat komponentit ja funktiot ESM-yhteensopivasta CDN-paketista, tässä tapauksessa esm.sh. Tässä lähestymistavassa ei ole mitään vikaa, mutta siinä tarvittavat resurssit haetaan ulkoiselta sivustolta, jolloin skriptit voivat lakata toimimasta, jos CDN on poissa käytöstä.

Blockstudio sisältää kätevän tavan ladata ES-moduuleja lohkoon, jolloin ulkoisia ESM-CDN-palveluja ei tarvita tuotantokäytössä.

Määritys

Lataa moduuli lohkohakemistoosi käyttämällä npm:-etuliitettä, jota seuraavat paketin nimi ja versio:

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

Tämä syntaksi noudattaa Deno-palvelun npm-määrityksen mukaista käytäntöä.

Huomautus

Vanhaa blockstudio/-etuliitettä (e.g., blockstudio/preact@10.15.1) tuetaan yhä taaksepäinyhteensopivuuden vuoksi, mutta uusissa projekteissa suosittelemme käyttämään npm:-etuliitettä. Katso lisätiedot siirto-oppaasta.

Blockstudio tarkistaa automaattisesti muutetuista .js-tiedostoista tuonnit ja lataa ne paikalliseen lohkohakemistoon. Ladatut tiedostot sijoitetaan lohkohakemiston modules-kansioon.

Skriptitiedosto kirjoitetaan tallennettaessa uudelleen, jotta se käyttää paikallisesti isännöityä moduulia:

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

Muokkaimessa käytetään esikatselun ja lohkon työstön aikana edelleen CDN-URL-osoitetta (Blockstudio käyttää esm.sh).

Rajoitukset

Versio

Tavallisesti moduuleja voi käyttää CDN-palveluista ilman versionumeroa. Tällöin käytössä on aina uusin versio. Koska Blockstudio ei tallenna tietoja tietokantaan, moduuleja käytettäessä tarvitaan versionumero.

Samat moduulit

Moduulit kuuluvat lohkoihinsa. Vaikka käyttäisit samaa moduulia samalla versionumerolla useissa lohkoissa, Blockstudio lataa pyydetyn moduulin silti kuhunkin lohkoon. Tämä johtuu pääasiassa siitä, että lohkojen tulee olla itsenäisiä kokonaisuuksia, joita voi jakaa helposti muihin asennuksiin tai sivustoihin.

Lisäksi sama moduuli pyydetään kahdesti, jos molemmat lohkot ovat samalla sivulla. Ongelma voidaan ratkaista käyttämällä tiedoston script.js sijaan script-inline.js-tiedostoa. Blockstudio muuttaa kunkin tuonnin osoittamaan moduulin ensimmäiseen sijaintiin, jos nimi ja versionumero ovat samat.

CSS-lataaja

CSS-tiedostoja voi tuoda myös yllä kuvatulla syntaksilla.

JavaScript
import "npm:swiper@11.0.0/swiper.min.css";

CSS-tiedosto ladataan modules-kansioon ja lisätään automaattisesti jonoon, kun lohkoa käytetään. Jos versio on sama, vain yksi CSS-tiedosto lisätään jonoon, vaikka se olisi useissa lohkoissa.