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:
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:
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.
@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.
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.
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ä:
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:
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äännpm:-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:
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.
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.